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Preface 


This manual describes the PLZ/ASM assembly language for the Zilog 
Z8000 microprocessor, and serves as the primary reference manual 
for the assembly language programmer. It is one in a series of 
documents describing the 28000 and associated hardware and 
software. Information on the use of the PLZ/ASM Assembler can be 
found in the publication: 


Z8000 Assembler User's Guide 


It is intended that this manual be read the first time in 
sequence, from beginning to end. 


Chapter 1 provides an overview of the architecture of the 28000, 
with special emphasis on those features of interest to the 
assembly language programmer. A detailed description of the 
architecture and hardware-related features can be found in the 
publication: 


Z8000 CPU Technical Manual (To be published) 


Chapter 2 introduces assembly language conventions, including the 
format of statements and addressing mode specifications. 


Chapter 3 contains the detailed instruction set of the 28000. 


Chapter 4 introduces the high-level PLZ/ASM statements needed to 
construct a complete program, while Chapter 5 contains the 
detailed description of these statements. 


The Appendices contain a summary of the instruction set, 
high-level statements and assembler directives, plus a table of 
the ASCII character set. 
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Section | 
Architectural Overview 


1.1 INTRODUCTION 


Zilog's 28000 microprocessor has been designed to accommodate a 
wide range of applications, from the relatively simple to the 
large and complex. Depending on the Z8000 configuration chosen, 
the programmer can directly address from 64 kilobytes (64K or 
65,536 bytes) to 8 megabytes (8M or 8,388,608 bytes) of memory. 


The 28000 achieves high throughput with a relatively low clock 
rate (standard: 4MHz) and can, therefore, use memories with a 
comparatively long access’ time. Built-in random-access memory 
(RAM) refresh with a programmable refresh rate permits the use of 
a wide variety of dynamic memories. 


28000 central processing unit (CPU) resources include sixteen 
16-bit general-purpose registers, seven data "types" (lengths 
from single bits to 32-bit long words), eight addressing modes, 
and a repertoire of 105 instructions. These resources are 
similar in form to comparable features of the 2Z8-microcomputer 
and 2Z80-microprocessor families, allowing users of these systems 
to upgrade easily to the 28000. 


Over 410 meaningful combinations of instructions, data types, and 
addressing modes are available with the 28000. The instruction 
set also includes signed multiplication and signed division 
(implemented in hardware) for both 16-bit and 32-bit values. 


The 28000 provides several sophisticated features not found on 
other microprocessors. Since reference to these features are 
made throughout this manual, a brief description of each of the 
major concepts and terminology follows: 


@® Segmentation 


To facilitate the management of a large address space, the 
Z8000 allows program and data to be accessed as part of 
variable-length logical groupings called "segments". 
Segmentation provides hardware assistance for relocation of 
program and data, as well as protection against accidental 
or malicious damage to system or user information (see 
Section 154) . 
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Stacks 


The 28000 has several instructions which facilitate the 
handling of stacks (Section 1.5.3). A "stack" is an area 


of memory used for temporary storage or re-entrant 
procedure cell/interrupt service linkage information, and 
is managed in a "last-in, first-out" manner; that is, 


several items may be "pushed" or added to the top of a 
stack and then "popped" or removed from the stack in 
reverse order. On the 28000, a stack starts at the highest 
address allocated for it and grows linearly downward to the 
lowest address as items are pushed. A general-purpose 
register is used to "point" to the current top of the 
stack; that is, the register contains the address of the 
most recently-pushed item. 


Interrupts and Traps 


Two events can alter the normal execution of a 28000 
program: asynchronous hardware "interrupts" which occur 
when a peripheral device needs service, and synchronous 
software "traps" which occur when an error condition arises 
such as an attempted use of an unimplemented instruction. 
The Z8000 handles both of these cases in a similar manner 


(Section 1.6.4). The current status of the processor is 
pushed on aé_e stack, and then program control is 
automatically "vectored" to a handler procedure for the 


particular class of interrupt or trap. The address of the 
handler is determined by indexing a table (or "vector") of 
program status blocks which is referred to as the Program 
Status Area, and extracting the appropriate entry that 
includes the address of the handler procedure. When the 
handler procedure is finished, control can be returned to 
the interrupted program through the status information 
Saved on the _ stack. (Non-vectored interrupts are also 
possible, with the burden placed on the program to 
determine which device needs servicing.) 


Normal and System Operating Modes 


28000 programs run in one of two operating modes: 
Normal mode or System mode. Normal mode is the operating 
mode during normal program execution. System mode exists 
primarily to protect the operating system kernel. 
Instructions that alter the machine state (such as I/O 
operations, changes to control registers, etc.) can be 
issued only in System mode and are referred to as 
"privileged" instructions. ; 
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Attempting to execute privileged System mode instructions 
while in Normal mode initiates a trap. This is an 
important feature in a multi-user environment. Programs 
running in normal mode cannot take over or monopolize 
control of the 28000 or damage other users’ programs or 
system software. System mode is also in effect following 
an interrupt or trap. 


Compiler and assembler code, the program code output by these 
translators, and operating system code, all run efficiently on 
the Z8000. Large address spaces, memory relocation, system and 
normal stacks, special instructions, and a sophisticated 
interrupt and trap structure add to this efficiency. 


The Z8000 can also be part of a multi-microprocessor system using 
its exclusion and synchronization software instructions and its 
Micro Input and Micro Output hardware controls. The large 
address space of the 28000 augments the overall data-processing 
capability of multi-microprocessor configurations. 


From a programmer's point of view, the basic 28000 system 
configuration consists of the 28000 microprocessor and its 
various memory and I/O address spaces. These are described in 
the remainder of this section. For detailed architectural and 
configuration data, see the 28000 Technical Manual. 


NOTE 


The 28000 is designed to provide for future 
extensions to its architecture which would require 
several of the currently unused (but reserved) 
bits in some of the instruction and data 
encodings. Any shaded or hatched areas in the 
figures throughout this manual are considered 
reserved and should not be used by the programmer. 
Reserved bits must be zero. 


1.2 MEMORY ADDRESS SPACES 


To allow for a wide range of applications, two versions of the 
Z8000 microprocessor device are available: a 40-pin package 
(Z8002) with an address range of 0-64K bytes, and a 48-pin 
package (Z8001) with an address range of 0-8M bytes (Figure 1-1). 
The 28002 version is called nonsegmented and the 28001 is the 
segmented version (see Section 1.4.1). 
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1.2.1 Four Memory Address Spaces 


When memory is addressed, the 28000 CPU distinguishes between 
e CODE memory, containing program instructions, and 
e@e DATA memory, including stack memory, 


both of which can be accessed in Normal and System operating 
modes. Thus, the programmer can address four distinct memory 
address spaces: system code memory, normal code memory, system 
data memory, or normal data memory. 


The specific space addressed is determined by the combination of 
outputs from the 28000 status pins, STO-ST3 (Figure 1-1). The 
status pins indicate various CPU operations such as memory or 1/0 
references, interrupt or trap acknowledgements, memory refresh or 


internal operations. Data memory reference, stack memory 
reference, instruction fetch of the first word of an instruction 
(IF1), and instruction fetch of the nth word of an instruction 


(IFn) each correspond to different status pin outputs, so that 
each address space can be distinguished by the memory hardware. 


Each of the four address spaces has a range as great as the 
addressing capability of the processor. For the user with a 
nonsegmented 28002 microprocessor, this means each address space 
can have up to 64K bytes, for a total system capacity of 256K 
bytes of directly-addressable memory. Similarly, a segmented 
28001 provides 32 megabytes of directly-addressable memory (up to 
8M bytes for each of the four address spaces). 


1.2.2 Addressing Memory Spaces 


Each memory address space can be viewed as a string of bytes 
numbered consecutively in ascending order. This "byte address" 
is the basic addressing element for the memory portion of a 28000 
system. The different methods for arriving at the byte address 
are discussed later in this section (Section 1.5.4). 


The byte address is used not only to address bytes, but also to 
address bits, 4-bit Binary Coded Decimal (BCD) digits, 16-bit 
words, and 32-bit long words. 
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In the case of a bit or digit, the memory address designates the 
byte or word that contains it. For example, a bit can be 
addressed by specifying a byte address and the number of the bit 
within the byte (0-7), or by specifying a word address and _ the 
bit number within the word (O=1'°5)):. Bits are numbered 
right-to-left; that is, least-to-most significant (Figure 1-2). 


In the case of data types longer than one byte, the memory 
address designates the leftmost, or high-order byte. In other 
words, the high-order byte has the lowest memory address of the 
bytes within a word or long word (Figure 1-2). 


Program instructions residing in code memory are always addressed 
as 16-bit words. Words and instructions are always aligned (the 


high-order byte must have an even-numbered address). Aligned 
words improve access speed and double the range of instructions 
that use relative addresses (JR, DJNZ, DBJNZ, CALR) -- see 


Section 1.5.4. The memory address of a long word must also be an 
even-numbered byte address. 


NOTE 


Word quadruples (64 bits) cannot be addressed in 
memory. It is possible to address 64-bit register 
quadruples, however. This is covered later, in 
Section ke Si. 2. 


1.3 INPUT/OUTPUT ADDRESS SPACES 


The 28000 has an I/O address space separate from the memory 
address space. I/O address references can be distinguished from 
Memory addresses using the status pin outputs from the 28000 
(Figure 1-1). 


I/O addresses are 16-bit addresses allowing a range of 0-64K 
bytes to be addressed. I/O addresses are multiplexed with the 
byte or word data accessed by the I/O operation. (See pins ADO - 
AD15 of Figure 1-1.) I/O data references have an automatic wait 
cycle included for each load or store, which results in a 4-cycle 
read or write. 


The 28000 instruction set includes two groups of I/0 
instructions: a standard complement of input, output, and _ block 
transfer instructions, plus). a "special" group Of 10/0 
instructions. The latter are generally used to load and examine 
the Memory Management Unit, a device used only in the segmented 
Z8000 system configuration (Section 1.4.2). Special I/O 
references can be distinguished from standard I/O references 
using the status pins (Figure 1-1.) 
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Figure 1-2 Addressable Data Elements 


1.4 SEGMENTATION 


The segmented 28000 memory address space may be separated into 
several (up to 128) variable-length "segments". Each segment may 
vary in size, independently from other segments, from 0 to 64K 
bytes. Addresses consist of both a segment number and an offset. 
The segment number is used as an index into a table of base 
addresses for each segment. The table is kept in a _ separate 


package called the Memory Management Unit (MMU). The 
corresponding table entry provides a base to which the offset is 
added, thus providing the final address. The term "logical 


address" is used to indicate the segmented address used by the 
programmer to construct his program. The term "physical address" 
is used to indicate the translated address which is passed to the 
physical memory hardware. This address translation is 
accomplished completely in hardware and does not affect the 
instruction execution time. 


Segmentation provides: 


1) Dynamic relocation of program and data memory without 
necessitating the modification of addresses. Since all 
instructions use addresses which are relative to the segment 
base registers, code and data segments can be relocated 
anywhere in memory simply by moving the information and 
setting the segment base registers (in the MMU) to new 
values. This provides great flexibility for multi-user or 
multi-task operating systems in efficiently managing memory 
allocations. 


2) Hardware-assisted memory protection to insure that only valid 
addresses within the bounds of the user's code and data 
segments are accessed. Since segments can be of variable 
length, only the amount of memory needed for each segment 
needs to be specified (independently from other segments). 


3) Large logical address space without necessitating large 
physical address space ("virtual memory"). Since logical 
addresses are 23 bits, up to 8M bytes per address space can 
be accessed. This space usually exceeds the size of the 
available physical memory address space. However, by using a 
combination of the MMU, some external hardware and some 
Operating system software, a virtual memory scheme can be 
employed which detects accesses to logical memory which are 
not currently mapped to physical memory, thus allowing the 
loading of segments from external secondary memory devices on 
demand. 


4) Controlled sharing of memory with several 78000 CPUs. Logical 
segments may be shared by several microprocessors by using 
the same MMU, or the same physical Memory segments may be 
Shared with several MMUs mapping different microprocessors' 
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logical address spaces into the same physical addresses. 
Relocation, protection and/or virtual memory facilities may 
be shared by several processors as well. 


The nonsegmented 28002 uses 16-bit addresses that can be 
manipulated as words. This version can directly address 64K 
bytes of memory in each of its four address spaces. The 
segmented, 28001 version uses 23 bits to address directly up to 
8M bytes in each of its four address_ spaces. The basic 
difference between programs running in nonsegmented or segmented 
modes is the number of bytes used to form addresses in 
instructions or registers. 


Code written for a nonsegmented 28000 can run in one segment of a 
segmented 28000. This is called "running the segmented z8000 in 
nonsegmented mode". The converse is not possible; i.e., code 
written for a segmented 28000 will not run properly on a 
nonsegmented 28000 due to differences in the instruction formats, 
and the use of register pairs for addressing modes. The 
functionality of the two versions is identical in all respects 
other than memory addressing. 


1.4.1 Nonsegmented and Segmented Addresses 


All nonsegmented addresses are represented as 16-bit words, 
whether they reside in a register, in memory, or as part of an 
instruction. 


Segmented addresses require 23 bits. Each 8-megabyte address 
space is divided into 128 segments from 0 to 64K bytes each. 
Thus, to address a byte in one of these spaces, two pieces of 
information are needed: 


e the segment number (0-127), which can be expressed in 7 
bits, and 


@e the offset from the beginning of the segment (i.e., the 
0-64K byte address within the segment), which can be 
expressed in 16 bits. 


The two parts of a segmented address may be manipulated 
separately. Word functions, including 16-bit arithmetic, can be 
performed on the offset portion. 


Figures 1-3 and 1-4 show internal representations of segmented 
addresses. The two words shown in Figure 1-3 could represent a 
long word in memory (Section 1.2.2) or a register pair in the CPU 
(Section 1.5.2). Within instructions, segmented addresses can 
have a long 16-bit offset or a short 8-bit offset. As Figure 1-4 
indicates, bit 7 of the segment-number byte is used to 
differentiate between these two formats. 
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1.4.2 Memory Management 


The segmented 28000 configuration usually includes a separate 
package called the Memory Management Unit (MMU). The MMU pin 
functions are pictured logically in Figure 1-5 and described 
below. These functions are divided between: 


® segment address relocation, and 
® memory protection. 


The MMU relocates segment addresses by converting them from 
"logical" to "physical" addresses. Logical addresses are those 
Manipulated by the program or specified in instructions, and 
output by the Z8000 CPU. Physical addresses are actual hardware 
locations. This address translation occurs automatically in the 
MMU and requires no programmer intervention (see Figure 1-6). 


As Figure 1-5 illustrates, the inputs to the MMU include the 


segment number and the upper eight bits of the offset. Each 
segment number is associated with a 24-bit "base" address 
equivalent to the first physical address in the segment. The 


16-bit offset is added to this base to complete the 24-bit 
physical address. Note that the lower eight bits of the offset 
are passed directly to the physical memory, so that the MMU need 
only store the upper 16 bits of each base address (bits 8-23). 
Figure 1-7 is another representation of the addition done by the 
MMU to form the 24-bit physical address. ; 


The other major function of the MMU is memory protection. By 
interpreting its four status lines (Chip Select, Address Strobe, 
Data Strobe, and Read/Write), the MMU can check 


System vs. normal segment status 
Code vs. data status 

Read/write vs. read-only status 
Invalid entry 

Segment size 


During each memory reference, the attributes for each segment are 
checked against the corresponding 28000 status lines. Re al 
Mismatch is detected, a trap is generated using the Segment Trap 
line (SEGT). 


The MMU functions constantly while memory is referenced, but its 
translation and protection tables are loaded and examined as an 
I/O peripheral. The Z8000's special I/O instructions (SIN, SOUT, 
and their variations -- see Section 3) can load or examine the 
MMU. 
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1.5 DATA MANIPULATION 


This section describes the 28000 CPU data manipulation features 
which are relevant to the assembly-language programmer. For 
information on CPU architectural or hardware features, see the 
Z8000 CPU Technical Manual. 


1.5.1 Data Types 


Z8000 instructions allow the programmer to work with seven 
different data types (or data lengths); five of these were 
described in Section 1.2.2 and Figure 1-2: 


Bits 

4-bit BCD digits 
8-bit bytes 
16-bit words 
32-bit long words 


Each of these can be addressed by specifying a byte address -- 
the byte containing a bit, digit or byte, or the high-order byte 
of a word or long word. For these five data types, the length to 
be used is implied by the operation. 


All five of these data types can also be processed in CPU 
registers (Section [abe 2))\s In this case, the instruction 
designates: 


@ a byte-register number (for a bit, digit, or byte 
data type), 


@® a word-register number (for a word data type), or 
@® a register-pair number (for a long word data type) 


Z8000 instructions allow bits to be set, cleared, and _ tested. 
Digits are used in BCD arithmetic operations. Bytes are used to 
handle characters or small integers (in the range 0 to 255 if 
unsigned, or in the range -128 to 127 if signed). Words can 
contain larger values (in the range 0 to 65535 if unsigned, or in 
the, <ranger  =32768-- to 327167  “r£ signed), instructions, OG 
nonsegmented addresses. Long words contain large values (in the 
range 0 to 4,294,967,295 if unsigned, or in the range 
-2,147,483,648 to 2,147,483,647 if signed) and segmented 
addresses. 


The two remaining data types, not discussed thus far are: 


@e Strings of bytes 
e Strings of words 
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Strings can be stored and referenced only in memory. They are 
referenced by designating either their lowest or their highest 
byte address plus their length in bytes or words. They are used 
with z8000 "autoincrement" or "“autodecrement" instructions, which 
automatically increase or decrease the pointer to a byte or word 
address (Figure 1-8). Note that when strings are used, the 
programmer must designate the length of the data element 
explicitly, as one of the instruction operands. 


1.5.2 General-Purpose Registers 


The 28000 CPU data manipulation capabilities are based on a 
powerful set of sixteen 16-bit, general-purpose registers which 
are used to hold temporary data and address calculations during 
the processing of data in the I/O and memory address spaces. The 
registers are specified in assembly language statements as RO 
through R15, which means they can be addressed by four bits. All 
sixteen registers can be used as accumulators. In addition to 
their use as accumulators in arithmetic and logical operations, 
IES of the 16 registers may be used in addressing mode 
calculations as either indirect, index or base-address registers. 
Because the instruction format encoding uses the value 0 to 
differentiate between various addressing modes, register RO (or 
the register pair RRO) cannot be used as an indirect, index or 
base-address register. 


The programmer can also address registers as groups of 8, 32, or 
even 64 bits (Figure 1-9). These registers are specified using 
the following assembly language symbols: 


e RHO, RLO;-RH1,-RE),-<<~, -RH7,;, RL? for 88-bit registers. 
(iHlseestands for high-order byte, and "L" stands for 
low-order byte within a word register). These registers 
overlap 16-bit registers RO - R7. All 8-bit registers 
can be used as accumulators. 


e RRO, RR2, RR4, ..., RR14 for 32-bit register pairs. 


e RQO, RQ4, RQB, and RQI2 for 64-bit register quadruples. 
These registers are used only by a few instructions’ such 
as Multiply, Divide, and Extend Sign. 


1.5.3 Stacks and Stack Pointers 


The 28000 is a register-oriented machine. It also has 
sophisticated stack-oriented instructions and includes separate 
hardware-maintained stacks for its two operating modes -- a 
system stack and a normal stack, residing in system data memory 
and normal data memory, respectively. In addition, since any 
general-purpose register (except RO) can be used as a 
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Figure 1-8 Byte and Word Strings 


programmer-maintained stack pointer with instructions such as 
Push and Pop, multiple stacks can be efficiently supported. The 


stack pointers (pointers to stack locations in data memory) are 
kept in general-purpose registers and, therefore, can be altered 
using standard instructions. No special stack-pointer 


instructions are needed. 


The processor stack is used implicitly by certain operations such 
as the Call and Return instructions or the interrupt and trap 
mechanisms. Depending on the System or Normal mode, these 
Operations use a hardware-defined stack pointer to access either 
the system processor stack or the normal processor stack. 


For the nonsegmented 28000, the system and normal processor 
stacks can be addressed by 16 bits. Register R15 is used for 
this purpose. For the segmented version, 32-bit pointers are 
required and register pair RR14 is used (Figure 1-9). The format 
of the 32-bit address is shown in Figure 1-3. 


As Figure 1-9 also shows, two copies of the stack pointer are 
needed -- one for the system stack and one for the normal stack. 
Although the stacks are separated in memory, the normal _ stack 
pointer (NSP) register can be accessed while in System mode using 
the Load Control Register (LDCTL) instruction. 


The two sets of stack pointers make task-switching easier. To 
make sure the normal stack is always free of system information, 
the normal program status data saved when an interrupt or trap 
occurs is pushed onto the system stack before the new program 
status is loaded (see Sections 1.6.4 and 1.6.5). 


1.5.4 Addressing Modes 


An assembly-language statement consists generally of an operation 
to be performed (instruction) and the data to be operated upon 
(operands). The latter include the source of the data and the 
destination where the result of the operation is to be stored. 


In its simplest form, an operand can be either the specific data 
to be processed (immediate data) or the name of a register that 
holds the data. Data can be specified in more complex ways, 
also. For example, an operand may name a register whose contents 
are added to the contents of another register to form the address 
of the memory location containing the source data (based indexed 
addressing). Data can be specified by eight distinct addressing 
modes: 
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in the nonsegmented Z8000. 


Figure 1-9 General-Purpose Registers 


Immediate Data (IM) 
Register (R) 

Indirect Register (IR) 
Direct Address (DA) 
Indexed Address (X) 
Relative Address (RA) 
Based Address (BA) 

Based Indexed Address (BX) 


Depending on the operation, the addressing mode to be used might 
be implied by an instruction or spelled out explicitly. When 
stated explicitly, the addressing mode usually refers to a 
register or memory location. Implied addressing modes usually 
refer to program (code) memory or the I/O address space. 


Immediate Data 


Although considered an "addressing mode" for the purpose of this 
discussion, Immediate Data is the only mode that does not 
indicate a register or memory address. The data processed by the 
instruction in this case is the value supplied as the operand. 


INSTRUCTION 
OPERAND 


THE OPERAND VALUE IS IN THE INSTRUCTION 


Immediate Data mode is often used to initialize registers. | The 
Z8000 is optimized for this function, providing several short 
immediate data instructions to reduce the byte count of programs. 


Register Addressing 


In Register addressing mode, the instruction processes data taken 
from a specified general-purpose register. Storing data ain <a 
register allows shorter instructions and- faster execution. 


REG 


INSTRUCTION OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE REGISTER 


The register length (byte, word, register pair, or register 
quadruple) is implied by the instruction. 


Ft 
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Indirect Register Addressing 


In Indirect Register addressing mode, the data processed is not 
the value in the specified register. Instead, the register holds 
the address of the data. 


REG 


INSTRUCTION ADDRESS OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS IN THE REGISTER 


A single word register is- used to hold the address’ in 
Nonsegmented mode, while a register pair must be used in 
Segmented mode. Any general-purpose word register (or register 
pair in Segmented mode) can be used except RO or RRO. This mode 
is also used by the I/O instructions to specify a "port" and 
always indicates a 16-bit I/O address held in a single word 
register. 


The Indirect Register mode may save space and reduce run time 
when consecutive locations are referenced. This mode can also be 
used to simulate more complex addressing modes, since addresses 
can be computed before the data is accessed. 


Direct Addressing 


In Direct Address mode, the data processed is found at the 
address specified as an operand. 


INSTRUCTION 
ADDRESS OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS IN THE INSTRUCTION 


This mode is also used by the I/O instructions to specify a 
"port" and always indicates a 16-bit I/O address. This mode is 
also used by Jump and Call instructions to specify the address of 
the next instruction to be executed (actually, the address serves 
as an imediate value that is loaded into the program counter). 
The address specified is limited to one word in Nonsegmented mode 
and in Segmented mode using the short offset (Figure 1-4). 
Segmented addresses using a long offset require a long word. 


Indexed Addressing 


In Indexed Address mode, the instruction processes data located 
at an indexed address in memory. The indexed address is computed 
by adding the address specified in the instruction to a 
"displacement" or "index". The index is contained in a _ word 
register, also specified in the instruction. Indexed Addressing 
allows random access to tables or other complex data structures 
where the address of the base of the table is known, but the 
particular element index must be computed by the program. 


REG 


INSTRUCTION DISPLACEMENT 
ADDRESS (+ }—= OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS THE ADDRESS IN THE INSTRUCTION, OFFSET BY THE 
CONTENTS OF THE REGISTER 


Any word register can be used as the index register except RO. 

The address operand is limited to one word in Nonsegmented mode, 
but can be one or two words in Segmented mode, depending on 

nr a a long or short offset is used in the address (Figure 
=A). 


Relative Addressing 


In Relative Address mode, the data processed is found at an 
address relative to the current instruction. The instruction 
specifies a two's complement displacement which is added to _ the 
program counter to form the target address. The program counter 
setting used is the address of the first instruction following 
the current relative instruction. 


PC 


INSTRUCTION ADDRESS 
DISPLACEMENT (+) OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS THE CONTENTS OF PC OFFSET BY THE DISPLACEMENT IN 
THE INSTRUCTION 
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As with Direct Address mode, Relative Address is also used by 
certain program control instructions to specify the address of 
the next instruction to be executed (specifically, the result of 
the addition of the program counter and the displacement is 
loaded into the program counter). 


Based Addressing 


Based Address mode is similar to Indexed Address mode. In Based 
Address, however, the register operand specifies the base address 
and the displacement is expressed as a 16-bit value. The two are 
added and the resulting address points to the data to be 
processed. This addressing mode may only be used with the Load 
instructions. Based Address, as a complement to Indexed Address, 
allows random access to tables or other data structures where the 
displacement of an element within the structure is known, but the 
base of the particular structure must be computed by the program. 


REG 


INSTRUCTION ADDRESS 
DISPLACEMENT (+) OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS THE ADDRESS IN THE REGISTER, OFFSET BY THE 
DISPLACEMENT IN THE INSTRUCTION. 


Any word register (or register pair in Segmented mode) can be 
used for the base address except RO or RRO. In Segmented mode, 
Based Address allows access to locations whose segment numbers 
are not known at assembly time. 


Based Indexed Addressing 


Based Indexed Address is an extension of Based Address, and may 
only be used with the Load instructions. In this case, both the 
base address and index (displacement) are held in registers. 


REG 


INSTRUCTION ADDRESS 


REG 


DISPLACEMENT -) OPERAND 


THE OPERAND VALUE IS THE CONTENTS OF THE LOCATION WHOSE 
ADDRESS IS THE ADDRESS IN THE REGISTER, OFFSET BY THE 
DISPLACEMENT IN THE REGISTER. 


Any word register (or register pair in segmented mode) can be 
used as the base address except RO or RRO. Any word register can 
be used as the index except RO. 


1.5.5 Instruction Formats 


28000 instructions may occupy one to four words, depending on the 
number of operands and the number of words needed to form operand 
addresses or immediate values. Figure 1-10 shows some of the 
formats for typical instructions and the main fields within these 
formats. 


Regardless of an instruction's length, its first byte contains 
the operation code (also referred to as the "opcode"). In 
addition to specifying the operation, this field also indicates 
the addressing mode (bits 14-15), and the word or byte data type 
(bit 8), as applicable. Instructions can designate zero or more 
operands explicitly. If the operands designate general-purpose 
registers, the register address(es) are usually specified in the 
second byte of the instruction. The format of these fields are 
detailed in Section 3. 


1.6 PROGRAM CONTROLS 


In addition to the general-purpose registers described in Section 
1.5.2, the 28000 CPU has several control registers containing 
status flags, control bits, the Program Counter, a pointer to the 
Program Status Area, and a memory refresh register. 


The status flags, control bits, and program counter are referred 
to collectively as the Program Status (PS). The Program Status 
is contained in two or four words, depending on whether’ the 
nonsegmented or segmented version of the 28000 is used (Figure 
1-11). The status flags and control bits are referred to 


collectively as the Flags and Control Word (FCW). 


3S 


36 


15 Simoes?’ 4 3 it) 


ADD R, DA 
direct address 


15 12 «#11 8 


7 0 
se coma[_ommie [ee |, sapegene 


Figure 1-10 Typical Instruction Formats (Nonsegmented) 
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Figure 1-11 Program Status Blocks 


1.6.1 Program Counter 


The Program Counter (PC) contains the address in program memory 
of the next instruction to be executed. As shown in Figure 1-1l, 
the Program Counter is 16 bits for the nonsegmented version and 
32 bits for the segmented version. The segmented address format 
is described in Section 1.4.1. 


1.6.2 Status Flags 


Status Flags (FLAGS) can be used to determine the outcome of 
certain operations and to redirect the flow of the program as 
necessary. The program status has six flags for the use of the 
programmer and the Z8000 processor: 


Carey ((C) 
zero (2) 
Sign’ (Ss) 


Parity/Overflow (P/V) 
Decimal Adjust (D) 
Half Carry (H) 


Z8000 CPU control instructions allow the programmer to set, reset 
(clear), or complement any or all of the first four flags. The 
half-carry and decimal-adjust flags are used only by the 28000 
for BCD arithmetic corrections. 


The FLAGS register can be separately loaded by the Load Control 
Register (LDCTLB) instruction without disturbing the control bits 
in the other byte of the FCW. The C, Z, S, and P/V flags can 
also be used with branching instructions to provide up to 21 
conditional tests and as loop controls in string instructions. 


The carry (C) flag, when set, generally indicates a carry out of 
the high-order bit position of a register being used as an 
accumulator. For example, adding two 8-bit numbers causes a 
carry out of bit 7 and sets the carry flag: 
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The zero (Z) flag is set when the result register's contents are 
zero following certain operations. 


The sign (S) flag is set to one when the most significant bit of 
a result register contains a one (a negative number in 
two's-complement notation) following certain operations. 


The overflow (V) flag, when set, indicates that a 
two's-complement number in a _ result register has exceeded the 
largest or is less than the smallest number that can be 
represented in a two's-complement notation. This flag is set as 
the result of an arithmetic operation. Consider the following 
example: 


Bit 


120 Ot 0 30)0 
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0 = carry flag 


The result in this case (-95 in two's complement notation) is 
incorrect, thus the overflow flag would be set. 


The same, bit. acts. as’ a Jparity (P), flag following logical 
instructions for byte operands only. The number of one bits in 
the register is counted and the flag is set if the total is even 
(that ase P=l).5 Tf the. total is odd), the, flagias reset .(P=0)). 


The decimal-adjust (D) flag is used for BCD arithmetic. Since 
the algorithm for correcting BCD operations is different for 
addition and subtraction, this flag is used to specify what kind 
of instruction was executed so that the subsequent Decimal Adjust 
(DAB) instruction can perform its function correctly. 


the halift-canry (H) £lag indreatesva-carry-out of, Or a borrow 
into bit 3 aS the result of adding or subtracting two BCD digits. 
This flag is used by the DAB instruction to convert the binary 
result of a previous decimal addition or subtraction into the 
correct decimal (BCD) result. 


Neither the decimal-adjust nor the half-carry flag is normally 
accessed by the programmer. The specific operations affecting 
the flags are detailed in Section 3 and listed in Appendix A. 


1.6.3 Control Bits 


The control bits are used to enable various interrupts. or 
Operating modes. The nonsegmented 28000 uses three control bits; 
the segmented version has four (Figure 1-11). These bits are: 


@® Vectored Interrupt Enable (VI) 

@® Non-Vectored Interrupt Enable (NVI) 

@ Segmentation Mode (SEG), used only by 
the segmented 28000 

e System/Normal Mode (S/N) 


The two interrupt control bits (VI and NVI) are set and reset by 
the Enable Interrupt (EI) and Disable Interrupt (DI) 
instructions. When the control bit is set to one, the 
appropriate interrupt is enabled; otherwise, it is disabled. 
Interrupts and interrupt handling are described further in the 
following two sections. 


The Segmentation mode bit has meaning only for the segmented 
version of the 28000. The setting of this bit indicates whether 
the Z8000 is running in Segmented (=1) or Nonsegmented mode (=0). 
The bit is set and reset by the LDPS or LDCTL instructions. 


The System/Normal bit indicates the operating mode of the 
program. When set to one, System mode is in effect; when reset 
to zero, Normal mode is in effect. This bit can be explicitly 
set or reset by the LDPS or LDCTL instructions, or implicitly 
changed by the occurrence of an interrupt or trap (Section 1.6.4) 
when a new program status is loaded. The programmer can also 
enter System mode from Normal mode (and change the setting of 
this control bit) by issuing a System Call (SC) instruction. 


Any control bit can be changed by the occurrence of an interrupt 
or trap, and then restored to its previous setting by terminating 
the interrupt handler procedure with an Interrupt Return 
instruction (IRET). The Interrupt Return pops the saved program 
status off the system stack. 


1.6.4 Interrupts and Traps 
Interrupts are asynchronous events and are typically triggered by 
peripheral devices needing attention. The three kinds of 
interrupts are: 

@ Non-Maskable interrupt (NMI) 


@e Vectored interrupt (VI) 
@® Non-Vectored interrupt (NVI) 
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Non-Maskable interrupts cannot be disabled, and are usually 
reserved for critical external events that require immediate 
attention. Vectored interrupts cause a 16-bit value output by 
the interrupting device to be read from the data bus (ADO-AD15) . 
This "vector" value is used to select a particular interrupt 
procedure to automatically branch to (Section T8623!) 
Non-Vectored interrupts are all handled by the same interrupt 
procedure, which may "poll" the external devices to determine 
which one requires attention. 


Diraps;, on the other hand, are synchronous events and usually 


indicate some special programming error or condition. They are 
triggered by specific instructions and _ recur each time the 
instruction is executed with the same set of data. The four 


kinds of traps are: 


Unimplemented instructions 

Privileged instructions in Normal mode 
Segmentation violations 

System call 


During the execution of an instruction, one of three kinds of 
error conditions can arise. An "illegal instruction exception" 
signifies that that the binary code of the current instruction is 
an illegal value for the architecture of the Z8000. The result 
of this error is undefined, so the programmer must not use binary 
instruction values other than those defined in the instruction 
set of Section 3. 


An “unimplemented instruction exception" signifies that the 
binary code of the current instruction is defined by the 28000 
architecture, but is not currently implemented by the hardware 
(Section 3.4). In this case, an Unimplemented Instruction trap 
occurs, which allows system software to either simulate the 
execution of the instruction or abort the program. 


An "operation exception" signifies that the binary code of the 
current instruction is valid, but the operand specification or 
execution of the instruction is architectyrally invalid. For 
example, an attempt to execute a privileged instruction in Normal 
mode will cause a trap. A segmentation violation, such as using 
an offset larger than the defined length of the segment, will 
cause the MMU to signal a Segmentation trap. (Segmentation traps 
occur only with the segmented 28000.) All other operation 
exceptions, such as specifying an odd address for a word data 
value, are considered programmer errors and_ the results are 
undefined. 
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The System Call instruction (SC) provides a controlled access 
from Normal mode software to System mode software, and is handled 
in a manner similar to the other traps. 


Because it is possible for several interrupts or traps to occur 
simultaneously, a priority for selecting which kind of interrupt 
or trap is honored first is established by the 28000 


architecture. The descending priority order of the traps and 
interrupts is: internal trap (unimplemented instructions, 
privileged instructions and the System Call instruction), 


Non-Maskable interrupt, Segmentation trap, Vectored interrupt, 
and Non-Vectored interrupt. 


Interrupts and traps are handled similarly by the 28000 hardware. 
At the start of the interrupt or trap sequence, the 28000 is 
forced into System mode. In addition, the segmented version of 
the 28000 is forced into Segmentation mode, regardless of the 
current mode. The program status information in effect just 
prior to the interrupt or trap is pushed onto the system stack. 
An additional word, indicating the "identifier" for the interrupt 
or trap, is also pushed onto the system stack, where it can be 
accessed by the interrupt or trap handler (Figure 1-12). The new 
program status is set up as described in the following section 
(which includes loading the program counter with the starting 
address of the procedure for servicing the interrupt or trap), 
and then control is transferred to the service procedure. 


For internal traps, the "identifier" stored in the system stack 
is the first word of the instruction causing the trap. For 
interrupts and external traps (such as a segmentation trap), the 
"identifier" stored is the 16-bit value read from the data bus 
(ADO-AD15) at the start of the interrupt acknowledge sequence. 
In the case of Vectored interrupts, this value is also used to 
select the appropriate service procedure, as explained in _ the 
following section. 


1.6.5 Program Status Area 


As part of a system software configuration, the user must provide 
service procedures to handle the various interrupts and traps. 
The procedures are accessed through their respective program 
status blocks (Figure 1-11) which determine the new program 
status set up when program execution is interrupted. These 
status words reside in a reserved area of memory called the 
Program Status Area, also established by the programmer, and 
should be arranged as shown in Figure 1-13. The ordering tS 
important, because the specific program status block selected 
(and consequently the service procedure selected) is determined 
implicitly from the kind of interrupt or trap that occurred. 
Note that the size of each program status block depends on the 
version of the 28000 (two words for the nonsegmented and _ four 
words for the segmented version). 


41 


42 


NONSEGMENTED 


STACK POINTER 
AFTER TRAP ——>| IDENTIFIER 


OR INTERRUPT | Fcw 
STACK POINTER 
BEFORE TRAP) ——> f= eo 
OR INTERRUPT 


SEGMENTED 


LOW 
ADDRESS 


SP AFTER ——+| IDENTIFIER 


PC SEGMENT 
PC OFFSET 


SP BEFORE ——> 


HIGH 
ADDRESS 


Figure 1-12 Format of Saved Program Status 
in the System Stack 


PROGRAM STATUS AREA POINTER 


eel | upper [00...0 || 


PROGRAM OFFSET* 


OFFSET : SEGMENTED 
STATUS AREA ( 
piece ayy We 28000) 


0 0 
OFFSET* RESERVED 
(NON-SEGMENTED 
28000) - ; 
UNIMPLEMENTED 
INSTRUCTION 
5 PRIVILEGED | ‘© 
INSTRUCTION 
12! systemcatt | 24 
INSTRUCTION 
16 SEGMENT 32 
TRAP** 
20 | NON-MASKABLE | 4° 
INTERRUPT 
24 | NON-vecTorED | 48 
INTERRUPT 
28 | VECTORED INT. | 56 
30 NEW PC 60 
32 NEW PC 64 
ssi fier ar 2 
“OFFSETS IN BYTES VECTORED 
**UNUSED FOR NON-SEGMENTED 28000 INTERRUPT 
JUMP TABLE 
540 pt MENES 5] 1080 


Figure 1-13 


Program Status Area 


43 


For each kind of interrupt or trap other than a Vectored 
interrupt, there is a single program status block that 1s 
automatically loaded into the Program Status registers (which 
includes the Flags and Control Word and the Program Counter). 
Control is then passed to the service procedure whose starting 
address is contained in the Program Counter. 


For all Vectored interrupts, the same Flags and Control Word 
(FCW) is loaded from the corresponding program status block. 
However, the appropriate Program Counter (PC) value is selected 
from up to 256 different values in the Program Status Area. The 
low-order eight bits of the "identifier" placed on the data bus 
by the interrupting device is used as an index into the Program 


Status Area following the FCW for Vectored interrupts. The 
"identifier" values.0. selects the first PC value, the value l 
selects the second PC, and so on up to the "identifier" value 
255. 


The Program Status Area is addressed by a_ special control 
register, the "Program Status Area Pointer", or PSAP. This 
pointer is one word for the nonsegmented and two words for the 
segmented 28000. As shown in Figure 1-14, the pointer contains a 
segment number (if applicable) and the high-order byte of a 
16-bit offset address. The low-order byte is assumed to contain 
zeroes, thus the Program Status Area must start on a 256-byte 
address boundary. The programmer accesses the PSAP using the 
Load Control Register instruction (LDCTL). 


1.6.6 System Reset 


A system reset overrides all other conditions, including all 
other interrupts or traps. When a reset sequence is begun, a 
4-word program status is fetched from segment 0, offset 0 for the 
segmented 28000; for the nonsegmented version, the program status 
occupies two words at address 2. 


During the reset sequence, the status pins and other outputs 
indicate System mode; in addition, Segmentation mode is in effect 
for the segmented 28000. No information is saved on the system 
stack when a reset occurs since the stack pointer has not yet 
been initialized. 


1.6.7 Memory Refresh 


The refresh control register (REFRESH) is a 16-bit counter used 
to refresh dynamic memory automatically. A special refresh 
memory access is made at progammable intervals and is otherwise 
invisible to the currently executing program. This register has 
the format shown in Figure 1-15 and, like the other control 
registers, can be programmed using the Load Control Register 
(LDCTL) instruction. 
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PSAP upper offset 


NONSEGMENTED 


PSAPOFF upper offset Ex 


SEGMENTED 


Figure 1-14 Program Status Area Pointer 


15 14 98 0 


4 | RATE COUNTER 


REFRESH ENABLE 


Figure 1-15 Refresh Register 
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The refresh rate (the time between successive refreshes) is 
determined by the 6-bit prescaler. This is a modulo-n counter (n 
= 1-64) driven at one-fourth the system clock rate. Thus, with a 
4 MHz clock, the refresh period is programmable from 1 to 64 
microseconds. 


The refresh row counter is 9 bits and is incremented by 2 each 
time the prescaler times out (reaches zero). This allows up to 
256 rows for future high-density memories. (Currently available 
16K dynamic RAMS have 128 rows.) 


Memory refresh can be totally disabled, if necessary, by setting 
bit 15 of the refresh register to zero. 


1.7 ADDRESS ARITHMETIC 


1.7.1 WNonsegmented Addressing 


In the nonsegmented 28000, all addresses are 16-bit values. When 
addressing mode arithmetic is performed, the result is always 
taken modulo 65536. No carry is generated or any other 
indication that the result of addition or other addressing 
Operations may have overflowed 16 bits. Thus in Indexed, 
Relative, Based and Based Indexed addressing modes, or in 
autoincrement and autodecrement instructions, the resulting 
address always remains within the 0 to 65535 addressing space. 


1.7.2 Segmented Addressing 


In the segmented 28000, all memory addresses are 23-bit values, 
consisting of a 7-bit segment number and a 16-bit offset. The 
short offset format (Figure 1-4) contains an 8-bit offset which 
is extended to include 8 high-order zero bits before further 
addressing computations are performed. When addressing mode 
arithmetic is performed, only the 16-bit offset is used so that 
the result is taken modulo 65536 as in nonsegmented addressing. 
No carry out of the l6-bit offset is generated, nor is any other 
indication that the result of addition or other addressing 
operations may have overflowed 16 bits. In other words, the 
segment number is not affected by addressing arithmetic. Thus in 
Indexed, Relative, Based and Based Indexed addressing modes, or 
in autoincrement or autodecrement instructions, the resulting 
address always remains within the same segment with the offset in 
the range 0 to 65535. 
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Nonsegmented programs can be run in one segment of the segmented 
Z8000 by setting the Segmentation mode control bit to zero with 
the LDPS or LDCTL instructions. In this case, the current value 
of the Program Counter's segment number is used for all memory 
accesses. While "running the segmented 28000 in Nonsegmented 
mode", the rules of nonsegmented addressing mode arithmetic 


apply. 
All I/O addresses are 16-bit values, regardless of whether memory 


addresses are segmented or nonsegmented. Therefore, all I/0 
address arithmetic follows the rule for nonsegmented addressing. 
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Section 2 
Z8000 Assembler Conventions 


2.1 ASSEMBLER OVERVIEW 


The 28000 microprocessor is programmed in a symbolic assembly 


language (PLZ/ASM). This marks a significant improvement over 
coding in binary notation. The operation codes for 
assembly-language statements are easily memorized (for example, 
SUBSEOG Subtract> and “LD “for Toad). In addition, meaningful 


symbolic names can be assigned to program addresses and data (for 
example, ALLOCATE as the label of the first statement in a 
storage allocation procedure). 


A 28000 source module is’ made up, for the most part, of such 
assembly language statements. These statements are then 
translated by the Z8000 assembler into an object module that can 
either be separately executed by the 28000 microprocessor, or can 
be linked with other object modules to form a complete program. 
Because the assembler has some high-level features, a source 
module can also include PLZ constructs such as DO and IF 
statements. The user can also embed assembler directives, which 
control the operation of the assembler, in the source module. 
High-level statements and assembler directives are discussed in 
Sections 4 and 5. 


Depending on the assembler directives used, addresses within an 
object module or program can be absolute (meaning addresses in 
the source program correspond exactly to 28000 logical memory 
addresses) or relocatable (meaning addresses can be assigned 
relative to some logical base address at a later time). Object 
modules should be made relocatable wherever possible. This 
facilitates both the ability to link with other object modules as 
well as the ability to load object programs anywhere in memory. 
It also allows the creation of libraries of commonly used 
Procedures (including math or input/output routines) that can be 
linked selectively into Several programs as desired. 


Operation of the assembler, module linkage, address relocation, 


and program execution are the subject of the 28000 Assembler 
User's Guide. 
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2.2 ASSEMBLY LANGUAGE STATEMENT FORMAT 


The most fundamental component of a PLZ/ASM program is the 
assembly language statement consisting of an instruction and its 
Operand(s). The instruction describes an action to be taken; the 
operand(s) supplies the data to be acted upon. 


An assembly language statement can include four fields: 
@® Statement label(s) 
@ An instruction 
@® Operand(s) 


@ Comments 


The statement label and comment fields are always optional. The 
statement has zero or more operands, depending on the instruction 
selected. The following statements have the same effect in a 
28000 program, but the second is more descriptive (and 
consequently more helpful in program debugging). 


Label Instruction Operand(s) Comment 
LD COUNT, #255 
INITCOUNT: LD COUNT, #255 !Load COUNT with 


initial value! 


Each of the elements of a PLZ/ASM program must be separated from 
other elements by one or more delimiters. A delimiter is one of 
the characters: space (blank), comma, semicolon, tab, carriage 
return, line feed, or form feed. Note that carriage return is 
treated just like any other delimiter, so that a single statement 
may span several lines, or several statements may appear on a 
single line. The delimiter used in a specific situation is up to 
the programmer. For the sake of illustration, this manual uses 
blanks to separate statement fields and commas’ to separate 
Operands. 


2.2.1 Program Labels and Identifiers 


Any assembly language (or high-level) statement in a 28000 


program can be preceded by any number of labels. Any statement 
referenced by another statement must be labeled. A label 
consists of an identifier followed by a colon (:) in the form: 
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labell: label2: ... labeln: statement 


A PLZ/ASM identifier can contain up to 127 characters, of which 
the first must be a letter. The remaining characters can be 
letters, digits, or the special character underscore aan) i 
Letters can be capitalized or lower-cased, but each time an 
identifier is used, it must be written in exactly the same way. 
The following are valid identifiers: 


START_UP_ROUTINE 
Program Initialization 
A 

Loop_12 

Nl 

sort 


In addition to their statement-labeling function, identifiers 
also serve as symbolic names for constants (Section 2.3.2), data 
variables (Section, 2.3.3), andl. procedures. (Section 5.21.2) . 
Certain identifiers serve as PLZ/ASM keywords and should not be 
used as programmer-defined identifiers (see Appendix D). 


An identifier can be associated with only one item within the 
scope of its definition. Section 4.2.5 explains the scope of 
identifiers, including the scope of labels. Labels are 
accessible within the module in which they are defined, and are 
not accessible outside that module unless specifically declared 
to be GLOBAL or EXTERNAL. 


2.2.2 Instruction 


The instruction is the assembly-language mnemonic describing a 
specific action to be taken. The instruction must be separated 
from its operand(s) by a delimiter. 


LD R56 SRO !Load register 5 from register 10! 
CLR R10 !Clear register 10! 


Many of the operations of the 28000 can be applied to word, byte, 
and long operands. A simple naming convention has been adopted 
to distinguish the size of the operands for these particular 
instructions: the suffix "B" designates a byte instruction, the 
suffix "L" designates a long word instruction, and no suffix 
designates a word instruction: 
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ADD RO, Re !Add word operands! 
ADDB RHO, RLO !Add byte operands! 


ADDL RRO, RR2 !Add long operands! 


2.2.3 Operand Field 


Depending on the instruction specified, this field can have zero 
Or more operands. If two or more operands are needed, each must 
be separated by a delimiter. 


IRET !No operand! 

COM R10 !One operand! 
ADD R6, #210 !Two operands! 
LDM R2, SAVEREG, #5 !'Three operands! 
CPD R2i,, “@RG;) R1 pag !Four operands! 


Operands supply the information the instruction needs to carry 
out its action. An operand can be: 


i 


@ Data to be processed (immediate data); 


@ The address of a location from which data is to be 
taken (Source address); 


@ The address of a location where data is to be put 
(destination address) ; 


@® The address of a program location to which program 
control is to be passed; 


@ A condition code, used to direct the flow of program 
control. 


Although there are a number of valid combinations of operands, 


there is one basic convention to remember: the destination 
operand always precedes the source operand. Refer to the 
specific instructions in Section 5} for valid operand 
combinations. 


Immediate data can be in the form of a constant, an address, or 
an expression (constants and/or addresses combined by operators). 
Each of these forms is described in Section 2.3. 
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LD RO, #K !Load constant K into reg 0! 


LD RO, #COUNTER !Load address of COUNTER into 
reg 0! 

ADD RO, #CON/3 + 5 !Add value of expression 
(CON/3 + 5) to contents of 
reg 0! 


Source, destination, and program addresses can also take several 
forms. PLZ/ASM addressing modes are described in Section 2.4. 
Some examples are: 


LD RO, @R5 !Load word value whose 
address is in register 5 
into register 0! 


LDB RH5, VARI !Load byte value located at 
address labeled VARI into 
register RH5! 


LDL RR1O, VARI + 1 !Load long value at location 
following that addressed by 
VAR1 into register pair 10-11! 


JP Z, LOOP1 !Jump to program address 
labeled LOOP] if zero flag (2) 
is set! 

JP NZ, LOOP] + 6 !Otherwise, jump to location 


six bytes after LOOP1! 


Condition codes are listed in Section 3.2.1. 


2.2.4 Comments 


Comments are used to document program code as a guide to program 
logic and also to simplify present or future program debugging. 
Comments can be inserted anywhere a program delimiter may appear. 
Comments are bounded by exclamation points (!) and can contain 
any characters except the exclamation point itself. 


!Module 3, Changed 7-25-78! 
RES Riis. #3 ret 


A single comment can cross line boundaries; that is, carriage 
returns can occur within a comment. 
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2.3 ARITHMETIC OPERANDS 


2.3.1 Run-Time vs. Assembly-Time Arithmetic 


Arithmetic is performed in two ways in an assembly language 
Program. Run-time arithmetic is done while the program is 
actually executing. 


SUB R10, R12 !Subtract the contents of register 
12 from the contents of register 10! 


Assembly-time arithmetic is done by the assembler when the 
program is assembled and involves the evaluation of arithmetic 
expressions in operands, such as the following: 


LD - RO, (22/7 + X&) 
JP 2Z, LOOP1 + 12 
ADD R2, HOLDREG-1 


Assembly-time arithmetic is more limited than run-time arithmetic 
in such areas as signed vs. unsigned arithmetic and the range of 
values permitted. 


Only unsigned arithmetic is allowed in assembly-time expression 
evaluation. Run-time arithmetic uses both signed and unsigned 
modes, as determined from the assembly-language instruction 
specified and the meaning attached to operands by the programmer. 


All assembly-time arithmetic is computed using 32-bit arithmetic, 
"modulo 4,294,967,296" (2 raised to the thirty-second power). 
Values greater than or equal to 4,294,967,296 are divided by 
4,294,967,296 and the remainder of the division is used as the 
result. Depending on the number of bits required by the 
particular instruction, only the rightmost 4, 8, 16, or 32 bits 


of the resulting 32-bit value are _ used. RE =the ,.resul.t ..of 
assembly-time arithmetic is to be stored in four bits, the value 
is taken "modulo 16" to give a result in the range 0 to 15. LE 


the result is to be stored in a single byte location, the value 
is taken "modulo 256" to give a result in the range 0 to 255 (or 
-128 to 127 if signed representation is intended). If the result 
is to be stored in a word, the value is taken "modulo 65536" to 
give a result in the range 0 to 65535 (or -32768 to 32767 if 
Signed representation is intended). 
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LDB RL4, #X+22 'Result of (X+22) must be in 
range -128 to 255! 


JP X+22 !Modulo 65536. Result is the 
address 22 bytes beyond x! 


ADDL RR12, #32000*MAX 'Result of (32000*MAX) is taken 
modulo 4,294,967,296! 


2.3.2 Constants 
A constant value is one that doesn't change throughout the 
program. Constants may be expressed as numbers, as character 


sequences, or aS a symbolic name representing a constant value. 


Numbers can be written in decimal, hexadecimal, binary, or octal 
notation. The latter three are preceded by a percent sign (%) 


and, in the case of binary and octal, by a base specifier 
enclosed in parentheses. If a number has no prefix, decimal is 
assumed. 

10 decimal 

$10 hexadecimal 

SAFOF hexadecimal 

%$(2)10110010 binary 

%(8)70 octal 


A character sequence is a sequence of one or more characters 
enclosed in single quote marks. Any ASCII character (except a 
percent sign or single quote) can be included in the character 
sequence. 


tA! 

'This is a character sequence’ 
A character can also be represented in a character sequence in 
the form "%hh," where "hh" is the hexadecimal equivalent of the 


ASCII code for the character. (See Appendix E for the ASCII 
character set and its hexadecimal equivalents.) 


"Here is an ESC character: %1B' 


For convenience, certain ASCII characters have been assigned 
shorter, more mnemonic codes as follows: 


21 Sor ‘eal Linefeed 

ST. O© Set Tab 

SR or $%r Carriage Return 
SP’ or | Bp Page (Form Feed) 
SB Percent Sign 

$Q or %q Single Quote 


Example: 


"First lineS$rSecond linegr' 
"Quote%Qinside a quote%Q' 


A constant can be assigned a symbolic name by a constant 
definition (CONSTANT) statement. A symbolic identifier, once 
associated with a constant value, retains that value through the 
entire program module. 


Constant symbols are defined by the CONSTANT statement in the 
form shown below. Identifiers follow the rules outlined in 
Section 2.2.1. The special character pair ":=" can be read "is 
defined as". 


CONSTANT 
REC_LENGTH := 64 
BUFFER_LENGTH := 4*RECLENGTH 
SEMICOLON Sear 
BIGNUMBER := 1000000 
smallnumber ie = 


It is also possible to create a new symbol which will be treated 
the same as any reserved keyword (see Appendix D for a list of 
reserved keywords). If the symbol on the right side of the ':=' 
in a CONSTANT statement is a keyword, then the symbol on the left 
side can be used thereafter any place the keyword would be valid. 
One important use of this ability is to "rename" a register such 
as R5 with amore meaningful name such as SUBTOTAL (of course, 
the symbol R5 can still be used). The programmer is cautioned, 
however, that renaming keywords in general can lead to confusing 
and difficult to maintain programs. 


2.3.3 Data Variables 


A data variable can be thought of as a "container" that can hold 
different values from time to time. Just as a physical 8-ounce 
container can hold 0-8 ounces of liquid, an 8-bit (BYTE or 
SHORT INTEGER) variable can hold values in the range 0 to 255 if 
unsigned, or -128 to 27 if signed two's complement 
representation is intended. A 16-bit (WORD or INTEGER) variable 
can hold values in the range 0 to 65535 if unsigned, or -32768 to 
32767 if. »signed. Similarly, a 32-bit (LONG or LONG INTEGER) 
variable can hold values in the range 0 to 4,296,967,296 (or 
-2,148 ,483 ,648 to 2,148,483,647 if signed two's complement 
representation is intended). 
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NOTE 


While it is suggested that BYTE, WORD, and LONG 
variables be used for unsigned values, and 
SHORT_INTEGER, INTEGER, and LONG INTEGER 
variables be used for signed values, there are no 
restrictions on whether a particular variable is 
signed or unsigned. In other words, BYTE and 
SHORT INTEGER are treated as equivalent, as are 
WORD and INTEGER, as are LONG and LONG INTEGER, 
with the appropriate interpretation left entirely 
to the programmer. 


A data variable name can be associated with a data memory 
location; the value of the variable is the contents of that 
location at the time the variable is referenced. A data variable 
name is a symbolic identifier and follows the rules’ for 
identifiers in Section 2.2.1. 


LD R5, MPLIER !Load the value contained in the 
location symbolized by MPLIER! 


ADD R5, 4 + SUBTOTAL !Add the value contained in the 
: location 4 bytes after the loca- 
tion addressed by SUBTOTAL to 
the contents of register 5! 


If a data variable operand is preceded by "#," it is treated as 
immediate data and the value used is the data address associated 
with the variable, not. > the’ © contents’ \'of P'the location. For 
example, suppose location 50 has the symbolic name COUNTER and 
contains the bit pattern 11111111 (decimal 255). 


LDB RLO, COUNTER !255 is loaded into RLO! 
LDB RLO, #COUNTER !50 is loaded into RLO! 
LDB RLO, COUNTER - 5 !Contents of location 45 are 


loaded into RLO! 
LDB RLO, #COUNTER - 5 !45 is loaded into RLO! 


Every data variable name has a type and scope associated with ts 
as well as a value. The type and scope (and, optionally, the 
initial value) are defined in a vdriable declaration statement 
like the following: 


INTERNAL 
SWITCH1 BYTE 
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In this example, "INTERNAL" is the scope of the variable SWITCH], 
and "BYTE" is its type. 


Variables can have GLOBAL, EXTERNAL, INTERNAL, or LOCAL scope. 
They can be one of the "simple" types BYTE or SHORT INTEGER (for 


8-bit values), WORD or INTEGER (for 16-bit values), or LONG or 
LONG INTEGER (for 32-bit values). They can also be one of the 
"structured" types ARRAY or RECORD. (Section 5.3.4 discusses 


variable declaration in more detail.) 


2.3.4 Expressions and Operators 


Expressions are formed using arithmetic, logical, shift, and 
relational operators in combination with constants and variables. 
These operators allow both unary (single-operand) and binary 
(two-operand) expressions, as shown below. 


Arithmetic Operators. The arithmetic operators are as follows: 


Operator Operation 
+ Unary plus, binary addition 


- Unary minus, binary subtraction 


* Unsigned multiplication 
if Unsigned division 
MOD Unsigned modulus 
The division operator (/) truncates any remainder. The MOD 


Operator returns the remainder from dividing its operands. 
17/4 =4 
17 MOD 4 =1 


If zero is specified as the right operand for either of these 
division operators, the result is undefined. 


Examples: 
ADD R5, #-3 !A minus 3 is adaed to 
register 5! 
ADD R5, #K + (5*3) !Value of constant K + 15 is 


added to register 5! 
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Note that expressions containing these operetors are evaluated at 
assembly time and, consequently, the arithmetic performed is 
unsigned. Signed arithmetic can still be done at run time. 


Logical Operators. The logical operators are as follows: 


Operator Operation 
LNOT (Unary) Logical complement 
LAND Logical AND 
LOR Logical OR 
LXOR Logical EXCLUSIVE OR 


LNOT simply complements the bit pattern of its (single) operand. 
All one bits are changed to zero and vice-versa. 


LD R2, #LNOT MASK !tReverse the bits ina 
mask and load into reg 2! 


The effect of LAND, LOR, and LXOR can be seen from the following 
examples. Although 32-bit arithmetic would actually be done by 
the assembler, 8-bit arithmetic is shown for clarity. Assume two 
constants A and B have the bit patterns 11110000 and 01010101, 
respectively. The expressions: 


A LAND B 


A LOR B 
A LXOR B 


will result in the following evaluations of the operands: 


LAND 11110000 LOR 11110000 LXOR 11110000 
01010101 01010101 01010101 
01010000 LAVTOLOL 10100101 


LAND sets a one bit whenever both ANDed bits are one; LOR sets a 
one bit whenever either ORed bit is one; LXOR sets a one bit when 
the two EXCLUSIVE-ORed bits are different. 


The assembly-time logical operations performed by LNOT, LAND, 
LOR, and LXOR can also be done at run time by the 28000 
instructions COM, AND, OR, and XOR. The assembly-time operations 
require less code and register manipulation. The run-time 
operations allow greater flexibility, however. For example, they 
can operate on registers (variables) whose contents are not known 
at assembly time, as well as on known constant values. 


Shift Operators. The shift operators are as follows: 


SHR Logical shift right 
SHL Logical shift left 


When used in expressions, the shift operators have the form 

d operator n 
where "d" is the data to be shifted and "n" specifies the number 
of bits to be shifted. Vacated bits are replaced with zeros. 
For example, if the constant PRODUCT is equal to 10110011, the 
statement 

LDB RLO, #(PRODUCT SHL 2) 
would load the value 11001100 into register RLO. 
If the second operand supplied is negative (that is, if the sign 
bit is set), it has the effect of reversing the direction of the 
shift. 

ADD PRODUCT, #(MPLIER SHR -1) !MPLIER is shifted left 

one bit position! 


Relational Operators. The relational operators are as follows: 


Greater than or equal 
Greater than 


< Less than 

<= Less than or equal 
= Equal 

<> Not equal 

+= 

> 


These six relational operators return a logical TRUE value (all 
ones) if the comparison of the two operands is true, and return a 
logical FALSE value (all zeros) otherwise. The Operators assume 
both operands are unsigned. 


LD RO,#(1=2) !Reg 0 is loaded with zeros! 
ED= RO,# (242) 1<"5 !Reg 0 is loaded with ones! 


Precedence of Operators. Expressions are generally evaluated 


left to right with operators having the highest precedence 
evaluated first. If two operators have equal precedence, the 
leftmost is evaluated first. 
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The following lists the PLZ/ASM operators in order of precedence: 
@ Unary operators: +, -, LNOT 


@ Multiplication/Division/Shift/AND: *, / , MOD, 
SHR, SHL, LAND 


e Addition/Subtraction/OR/XOR: +, -, LOR, LXOR 
@e Relational operators: <, <=, =, <>, >=, > 


Parentheses can be used to change the normal order of precedence. 
Items enclosed in parentheses are evaluated Firsts Is 
Parentheses are nested, the innermost are evaluated first. 


20/5 = 1273: = 0 
20/(5-—= 1273) = 20 


Modes of Arithmetic Expressions. All arithmetic expressions have 
a mode associated with them: absolute, relocatable, or external. 


These modes are defined in detail in Section 4, following the 
explanation of the concepts of "scope" and "program 
relocatability". 


2.3.5 Segmented Address Operators 


Two special operators are provided to ease the manipulation of 
segmented addresses. While addresses can be treated as a_ single 
value with a symbolic name assigned by the programmer, 
occasionally it is useful to determine the segment number or 
offset associated with a symbolic name. 


The "SEG" unary operator is applied to an address expression 
which contains a symbolic name associated with an address, and 
returns a 16-bit value. This value is the 7-bit segment number 
associated with the expression and a one bit in the most 
significant bit of the high-order byte, and all zero bits in the 
low-order byte (Section 1.4.1). 


The "OFFSET" unary operator is applied to an address expression 
and returns a 16-bit value which is the offset value associated 
with the expression. 


Example: LD R2,#SEG PTR 
LD R3,#OFFSET PTR 
!Load segmented address of PTR 
into register pair RR2, which 
is functionally equivalent to 
the following statement! 
LDL RR2,#PTR 


60 


Because of the special properties of these address Operators, no 
other operators may be applied to a_ subexpression containing a 
SEG or OFFSET operator, although other operators can be used 
within the subexpression SEG or OFFSET are applied to: 


SEG (PTR+4) {Valid} 
(SEG PTR) +4 {Invalid} 
-(OFFSET PTR) {Invalid} 


2.4 2Z8000 ADDRESSING MODES 


With the exception of immediate data and condition codes, all 
assembly-language operands are expressed as addresses: register, 
memory, and I/O addresses. The various address modes recognized 
by the 28000 assembler are as follows: 


Immediate Data 
Register 

Indirect Register 
Direct Address 
Indexed Address 
Relative Address 
Based Address 

Based Indexed Address 


Special characters are used in operands to identify certain of 
these address modes. The characters are: 


@ "R" preceding a word register number; 
e@ "RH" or "RL" preceding a byte register number; 
@e "RR" preceding a register pair number; 


e "RQ" preceding a register quadruple number; 


e "@" preceding an indirect-register reference; 
e "#" preceding immediate data; 
e "()" used to enclose the displacement part of 


an indexed, based, or based indexed address; 


e@ "S$" signifying the current program counter location, 
usually used in relative addressing. 


The use of these characters is shown in the following sections. 
Not every address mode can be used by every instruction. The 


individual instruction descriptions in Section 3 tell which 
address modes can be used for each instruction. 
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2.4.1 Immediate Data 


The operand value used by the instruction in Immediate Data 
addressing mode is the value supplied in the operand field 
itself. 


Immediate data is preceded by the special character "#" and may 
be a constant (including character constants and symbols 
representing constants) or an expression as described in Section 
2.3.4. Immediate data expressions are evaluated using 32-bit 
arithmetic. Depending on the instruction being used, the value 
represented by the rightmost 4, 8, 16, or 32 bits is actually 
used. An error message is generated for values that overflow the 
valid range for the instruction. 


LDB RHO, #100 !Load 100 into byte register RHO! 


LDL RRO, #%8000 * REP_COUNT 
!Load the value resulting from 
the multiplication of %8000 and 
the value of constant REP _COUNT 
into register pair RRO! 


If a variable name or address expression is prefixed by "#", the 
value used is the address represented by the variable or the 
result of the expression evaluation, not the contents of the 
corresponding data location. In Nonsegmented mode, all address 
expressions result in a 16-bit value. 


For segmented addresses, the assembler automatically creates the 
proper format for a long offset address which includes the 
segment number and the offset in a 32-bit value (Section 1.4.1). 
It is recommended that symbolic names be used wherever possible, 
since the corresponding segment number and offset for the 
symbolic name will be automatically managed by the assembler and 
can be assigned values later when the module is linked or loaded 
for execution. 


For those cases where a specific segment is desired, the 
following notation may be used (the segment designator 1s 
enclosed in double angle brackets): 


<<segment>>offset 
where "segment" is a constant expression which evaluates to a 
T=bit value, and "offset" is a constant expression which 


evaluates to a 16-bit value. This notation is expanded into a 
long offset address by the assembler. 
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LD RO, #DATATABLE + 12 !Add 12 to the address of 
DATATABLE and load the result 
into word register RO (non- 
segmented mode) ! 


LDL RR2, #ADDR !Load the address of ADDR into 
register pair RR2 (segmented 
mode) ! 

LDL RR2, #<<3>>%1234 !Load the segmented address 


with segment 3, offset %1234 
into register pair RR2 (seg- 
mented mode) ! 


2.4.2 Register Address 


In Register addressing mode, the operand value is the contents of 
the specified general-purpose register. There are four different 
sizes of registers on the 28000. 


@® Word register (16 bits) 

® Byte register (8 bits) 

@e Register pair (32 bits) 

e Register quadruple (64 bits) 


A word register is indicated by an "R" followed by a number from 
0 to 15 (decimal). These correspond to the 16 registers of the 
machine. Either the high or low byte of the first eight 
registers can be accessed by using the byte register constructs 
"RH" or "RL" followed by a number from 0 to 7. Any pair of word 
registers can be accessed aS a register pair by using "RR" 
followed by an even number between 0 and 14. Register quadruples 
are equivalent to four consecutive word registers and are 
accessed by the notation "RQ" followed by one of the numbers 0, 
4, 8, Or 12. 


If an odd register number is given with a register pair 
designator, or a number other than 0, 4, 8, or 12 is given for a 
register quadruple, an assembly error will result. 


In general, the size of a register used in an operation depends 
on the particular instruction. Byte registers are used with byte 
instructions, which end with the suffix "B". Word registers are 
used with word instructions, which have no special suffix. 
Register pairs are used with long word instructions, which end 


with thé -suffizoo*b"2 Register quadruples are used only with 
three instructions (DIVL, EXTSL and MULTL) which use a 64-bit 
value. An assembly error will occur if the size of a register 


does not correspond correctly with the particular instruction. 
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LD R5, #%3FFF !Load register 5 with the 
hexadecimal value 3FFF! 


LDB RH3, #%F3 !Load the high order byte of 
word register 3 with the 
hexadecimal value F3! 


ADDL RR2, RR4 !Add the register pairs 2-3 and 
4-5 and store the result in 2-3! 


MULTL RQ8, RR12 !Multiply the value in register 
pair 10-11 by the value in 
register pair 12-13 and store the 
result in register quadruple 
8=9-10-114 


2.4.3 Indirect Register Address 


In Indirect Register addressing mode, the operand value is the 
contents of the location whose address is contained in the 
specified register. A word register is used to hold the address 
in nonsegmented mode, while a register pair must be used in 
segmented mode. Any general-purpose word register (or register 
pair in segmented mode) can be used except RO or RRO. 


Indirect Register addressing mode is also used with the I/O 
instructions and always indicates a 16-bit I/O address. Any 
general-purpose word register can be used except RO. 


An Indirect Register address is specified by a "commercial at" 
symbol (@) followed by either a word register or a register pair 
designator. For Indirect Register addressing mode, a word 
register is specified by an "R" followed by a number from 1 to 
15, and a register pair is specified by a "RR" followed by an 
even number from 2 to 14 (Section 2.4.2). 


JP @R2 !Pass control (jump) to the 
program memory location 
addressed by register 2 
(nonsegmented mode) ! 


LD @R3, R2 !Load contents of register 
2 into location addressed by 
register 3 (nonsegmented mode) ! 


LD @RR2, #30 !Load immediate value 30 into 
location addressed by register 
pair 2-3 (segmented mode)! 
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2.4.4 Direct Address 


The operand value used by the instruction in Direct addressing 
mode is the contents of the location specified by the address in 
the instruction. A direct address may be specified as a symbolic 
name of a memory or I/O location, or an expression which 
evaluates to an address. In nonsegmented mode or for all I/O 
instructions, the address is a 16-bit value. In segmented mode, 
the memory address is either a 16-bit value (short offset) or a 
32-bit value (long offset). All assembly-time address 
expressions are evaluated using 32-bit arithmetic, with only the 
rightmost 16 bits of the result used for nonsegmented addresses. 


LD R10, DATUM !Load the contents of the 
location addressed by DATUM 
into register 10! 


LD STRUCT+8, R10 !Load the contents of register 
10 into the location addressed 
by adding 8 to STRUCT! 


JPL Gye $2000 !Jump to location %2000 if the 
carry flag is set (nonsegmented 
mode) ! 


INB RHO, 77 !Input the contents of the I/0 
location addressed by 77 into 
RHO! 


For segmented addresses, the assembler automatically creates the 
proper format which includes the segment number and the offset. 
It is.recommended that symbolic names be used wherever possible, 
since the corresponding segment number and offset for the 
Symbolic name will be automatically managed by the assembler and 
can be assigned values later when the module is linked or loaded 
for execution. 


For those cases where a specific segment is desired, the 
following notation may be used (the segment designator is 
enclosed in double angle brackets): 


<<segment>>offset 


where "segment" is a constant expression which evaluates to a 
7-bit value, and "offset" is a constant expression which 
evaluates to a 16-bit value. This notation is expanded into a 
long offset address by the assembler. 


To force a short offset address, the segmented address may be 
enclosed in vertical bars ("|"). In this case, the offset must 
be in the range 0 to 255, and the final address includes the 
segment number and short offset in a 16-bit value. 
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LD R10, |DATUM| !Load the contents of the 
location addressed by DATUM 
(short offset format) into 
register 10! 


LD <<STORAGE>>HEAD, R10 !'Load the contents of reg- 
ister 10 into the location 
addressed by the segment 
named STORAGE offset by 
HEAD (long offset format)! 


JPr il<<35>>Si2)| !Jump to location addressed 
by segment 3, offset $12 
(short offset format) ! 


2.4.5 Indexed Address 


An indexed address consists of a memory address displaced by the 
contents of a designated word register (the index). This 
displacement is added to the memory address and the resulting 
address points to the location whose contents are used by the 
instruction. In nonsegmented mode, the memory address is 
specified as an expression which evaluates to a 16-bit value. In 
segmented mode, the memory address is specified as an expression 
which evaluates to either a 16-bit value (short offset) or a 
32-bit value (long offset). All assembly-time address 
expressions are evaluated using 32-bit arithmetic, with only the 
rightmost 16 bits of the result used for nonsegmented addresses. 
This address is followed by the index, a word register designator 
enclosed in parentheses. For Indexed Addressing, a word register 
is specified by an "R" followed by a number from 1 to 15. Any 
general-purpose word register can be used except RO. 


LD R10, TABLE(R3) !Load the contents of the 
location addressed by TABLE 
plus the contents of reg- 
ister 3 into register 10! 


LD 240+38(R3), R10 !Load the contents of reg- 
ister 10 into the location 
addressed by 278 plus the 
contents of register 3 
(nonsegmented mode) ! 


For segmented addresses, the assembler automatically creates the 
proper format for the memory address which includes the segment 
number and the offset. As with Direct Addressing, symbolic names 
should be used wherever possible so that values can be assigned 
later when the module is linked or loaded for execution. 
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For those cases where a specific segment is desired, the 
following notation may be used (the segment designator is 
enclosed in double angle brackets): 


<<segment>>offset(R) 


where "Segment" is a constant expression which evaluates to a 
7-bit value, "offset" is a constant expression which evaluates to 
a l6é-bit value, and "R" is a word register designator. This 
notation is expanded into a long offset address by the assembler. 


To force a short offset address, the segmented address may be 
enclosed in vertical bars ("|"). In this case, the offset must 
be in the range 0 to 255, and the final address includes’ the 
segment number and short offset in a 16-bit value. 


LD R10, |TABLE| (R3) !Load the contents of the 
location addressed by 
TABLE (short offset format) 
plus the contents of reg- 
ister 3 into register 10! 


LD’ -<<STACK>> 8'(R1 33"), URW0 !Load the contents of reg- 
ister 10 into the location 
addressed by the segment 
named STACK offset by 8 
(long offset format) plus 
the contents of register 13 


2.4.6 Relative Address 


Relative address mode is implied by its instruction. It is used 
by the Call Relative (CALR), Decrement and Jump If Not Zero 
(DJNZ), Jump Relative (JR), Load Address Relative (LDAR), and 
Load Relative (LDR) instructions and is the only mode available 
to these instructions. The operand, in this case, represents a 
displacement that is added to the contents of the program counter 
to form the destination address that is relative to the current 
instruction. The original contents of the program counter is 
taken to be the address of the instruction byte followin the 
instruction. The size and range of the displacement depends on 
the particular instruction, and is described with each 
instruction in Section 3. 


The displacement value can be expressed in two ways. In the 
first case, the programmer provides a specific displacement in 
the form "Stn" where n is a constant expression in the range 
appropriate for the particular instruction and $ represents the 
contents of the program counter at the start of the instruction. 
The assembler automatically subtracts the value of the address of 
the following instruction to derive the actual displacement. 
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JR OW, SK !Add value of constant K to program 
counter and jump to new location if 
overflow has occurred! 


In the second method, the assembler calculates the displacement 
automatically. The programmer simply specifies an expression 
which evaluates to a number or a program label as in Direct 
Addressing. The address specified by the operand must be in the 
valid range for the instruction, and the assembler automatically 
subtracts the value of the address of the following instruction 
to derive the actual displacement. 


DJNZ R5, LOOP !Decrement register 5 and jump to 
LOOP if the result is not zero! 


LDR R10, DATA !Load the contents of the location 
addressed by DATA into register 10! 


2.457 Based Address 


A based address consists of a register that contains the base and 
a 16-bit displacement. The displacement is added to the base and 
the resulting address indicates the location whose contents are 
used by the instruction. 


In nonsegmented mode, the base address is held in a word register 
that is specified by an "R" followed by a number from 1 to 5's 
Any general-purpose word register can be used except RO. The 
displacement is specified as an expression which evaluates to a 
16-bit value, preceded by a "#" symbol and enclosed in 
parentheses. 


In segmented mode, the segmented base address is held in a 
register pair that is specified by an "RR" followed by an even 
number from 2 to 14. Any general-purpose register pair can be 
used except RRO. The displacement is specified as an expression 
which evaluates to a 16-bit value, preceded by a "#" symbol and 
enclosed in parentheses. 


LDL RR2, R1(#255) !Load into register pair 2-3 the 
long word value found in the 
location resulting from adding 
255 to the address in register 
1 (nonsegmented mode) ! 


LD RR4(#%4000), R2 ° !Load register 2 into the loca- 
tion addressed by adding %4000 
to the segmented address found 
in register pair-4-5 (segmented 
mode) ! 


2.4.8 Based Indexed Address 


Based Indexed addressing is similar to Based addressing (2.4.7) 
except that the displacement ("index") as well as the base is 
held in a register. The contents of the registers are added 
together to determine the address used in the instruction. 


In nonsegmented mode, the base address is held in a word register 
that is specified by an "R" followed by a number from 1 to 15. 
The index is held in a word register specified in a_ similar 
Manner and enclosed in parentheses. Any general-purpose word 
registers can be used for either the base or index except RO. 


In segmented mode, the segmented base address is held in a 
register pair that is specified by an "RR" followed by an even 
number from 2 to 14. Any general-purpose register pair can be 


used except RRO. The index is held in a word register that is 
specified by an "R" followed by a number from 1 to 15. Any 


general-purpose word register can be used except RO. 


LD R3, R&(RL5) !Load the value at the location 
addressed by adding the address 
in R8 to the displacement in 
R15 into register 3 (nonseg- 
mented mode) ! 


LDB RR14(R4), RH2 !Load register RH2 into the 
location addressed by the seg- 
mented address in RR14 indexed by 
the value in R4 (segmented mode) ! 
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Section 3 


Assembly Language Instruction Set 


3.1 FUNCTIONAL SUMMARY 


Z8000 PLZ/ASM instructions can be divided functionally into nine 


groups: 


Load and Exchange 

Arithmetic 

Logical 

Program Control 

Bit Manipulation 

Rotate and Shift 

Block Transfer and String Manipulation 
Input/Output 

CPU Control 


The instruction summary shows the instructions belonging to each 
functional group and the number of operands required for each. 
The following notation is used: 


Operations with word, byte and long word data operands 
are listed with their instruction mnemonics grouped 
together. The suffix "B" designates a byte instruction, 
the suffix "L" designates a long word instruction, and no 
suffix designates a word instruction. For some 
instructions, a data size is either not applicable or 
depends on the segmentation mode, and thus the 
instruction mnemonic does not have a suffix to indicate 
data size. 


"src" is the source operand ("srcl" and "src2" are used 
to distinguish between two source operands in the same 
instruction) 


"dst" is the destination operand 


"r" is a register operand, typically used as a counter 


"num" is a number; that is, an immediate value 


ce" is a condition code (Section 3:...2.1) 


“fiag" ds any combination of the C, 2; Sy, PB, and V 
status flags 


"int" is any combination of the VI and NVI interrupt 
control bits 


Instruction 


CLR 
CLRB 


EX 
EXB 


LD 
LDB 
LDL 
LDA 
LDAR 
LDK 
LDM 
LDR 
LDRB 
LDRL 


POP 
POPL 


PUSH 
PUSHL 


Instruction 


ADC 
ADCB 


ADD 
ADDB 
ADDL 


CP 
CPB 
CPL 


LOAD AND EXCHANGE INSTRUCTIONS 


Operand(s) 
dst 


dst,src 
dst,src 
dst,sre 
dst,src 
dst,src 
dst,src,num 
dst,src 


dst,src 


dst,src 


Name of Instruction 


Clear 


Exchange 


Load 


Load Address 
Load Address Relative 
Load Constant 
Load Multiple 


Load Relative 


Pop 


Push 


ARITHMETIC INSTRUCTIONS 


Operand(s) 


dst,src 


dst,src 


dst,src 


Name of Instruction 


Add with Carry 


Add 


Compare 


eL 


ARITHMETIC INSTRUCTIONS (continued) 


Instruction 


DAB 


DEC 
DECB 


DIV 
DIVL 


EXTS 
EXTSB 
EXTSL 


INC 
INCB 


MULT 
MULTL 


NEG 
NEGB 


SBC 
SBCB 


SUB 
SUBB 
SUBL 


Instruction 


AND 
ANDB 


COM 
COMB 


OR 
ORB 
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Operands(s) Name of Instruction 
dst Decimal Adjust 
dst,src Decrement 

dst,src Divide 

dst Extend Sign 
dst,srcec Increment 

dst,src Multiply 

dst Negate 

dst,src Subtract with Carry 
dst,src Subtract 


LOGICAL INSTRUCTIONS 


Operand(s) Name of Instruction 
dst,src And 

dst Complement 

dst,src Or 


LOGICAL INSTRUCTIONS (continued) 


Instruction Operand(s) Name of Instruction 
TEST dst Test 
TESTB 
TESTL 
TEC ee, ,dst Test Condition Code 
TCCB 
XOR dst,src Exclusive Or 
XORB 
PROGRAM CONTROL INSTRUCTIONS 
Instruction Operand(s) Name of Instruction 
CALL dst Call Procedure 
CALR dst Call Procedure Relative 
DJNZ rast Decrement and Jump if 
DBJUNZ Not Zero 
IRET Interrupt Return 
JP ec, dst Jump 
JR ecc,dst Jump Relative 
RET ec Return from Procedure 
SG src System Call 
BIT MANIPULATION INSTRUCTIONS 
Instruction Operand(s) Name of Instruction 
BIT dst,src Bit Test 
BITB 
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BIT MANIPULATION INSTRUCTIONS (continued) 


Instruction 


RES 
RESB 


SET 
SETB 


TSET 
TSETB 


Instruction 


RL 
RLB 


RLC 
RLCB 


RLDB 


RR 
RRB 


RRC 
RRCB 


RRDB 


SDA 
SDAB 
SDAL 


SDL 
SDLB 
SDLL 


SLA 


SLAB 
SLAL 


74 


Operand(s) 


dst,src 


ast ,.sre 


dst 


Name of Instruction 


Reset Bit 


Set Bit 


Test and Set 


ROTATE AND SHIFT INSTRUCTIONS 


Operand(s) 


dst,srce 
dst,src 


dst,src 


dst,src 
dst,;src 


dst,sre 


dst,src 


dst,src 


dst,src 


Name of Instruction 


Rotate Left 


Rotate Left through 
Carry 


Rotate Left Digit 
Rotate Right 

Rotate Right through 
Carry 

Rotate Right Digit 


Shift Dynamic Arithmetic 


Shift Dynamic Logical 


Shift Left Arithmetic 


ROTATE AND SHIFT INSTRUCTIONS (continued) 


Instruction Operand(s) Name of Instruction 
SLL dst,srec Shift Left Logical 
SLLB 
SLLL 
SRA dst,src Shift Right Arithmetic 
SRAB 
SRAL 
SRL dst,src Shift Right Logical 
SRLB 
SRLL 


BLOCK TRANSFER AND STRING MANIPULATION INSTRUCTIONS 


Instruction Operand(s) Name of Instruction 
CPD dst, sre, hice Compare and Decrement 
CPDB 
CPDR dsit,sre,r ,;ce Compare, Decrement and 
CPDRB Repeat 
CPI dst,stc,r,¢e Compare and Increment 
CPIB 
CPIR dst ,Ssrce;r,ce Compare, Increment and 
CPIRB Repeat 
CPSD dst ,sre;r,ce Compare String and 
CPSDB Decrement 
CPSDR dst,src,r,cce Compare String, Decrement 
CPSDRB and Repeat 
CPSI daSstipsne, Fr ce Compare String and 
CPSIB Increment 
CPSIR dst, Sree, © ce Compare String, Increment 
CPSIRB and Repeat 
LDD dst, Src, & Load and Decrement 


LDDB 


BLOCK TRANSFER AND STRING MANIPULATION INSTRUCTIONS (continued) 


Instruction Operand(s) Name of Instruction 
LDDR dsityisrc,r Load, Decrement and 
LDDRB Repeat 
LDI dst ;Sre,r Load and Increment 
LDIB 
LDIR dst,src,r Load, Increment and 
LDIRB Repeat 
TRDB dst,src,r Translate and Decrement 
TRDRB dst .sre,.r Translate, Decrement and 
Repeat 
TRIB dst, sre Translate and Increment 
TRIRB dsit,src,r Translate, Increment and 
Repeat 
TRTDB srelL, sre? ,r Translate, Test and 
Decrement 
TRTDRB srelysrc2.,r Translate, Test, Decrement 
and Repeat 
TRTIB Srcl,sre2Z,r Translate, Test and 
Increment 
TRTIRB srelysrce2,r Translate, Test, Increment 
and Repeat 
INPUT/OUTPUT INSTRUCTIONS 
Instruction Operand(s) Name of Instruction 
IN dst,src Input 
INB 
IND dst,sre,r Input and Decrement 
INDB 
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INPUT/OUTPUT INSTRUCTIONS 


Instructions Operand(s) 
INDR dst,src,r 
INDRB 
INI dSstssitc pr 
INIB 
INIR ast psc, fF 
INIRB 
OTDR ast; sre ;,£ 
OTDRB 
OTIR dst, sre,r 
OTIRB 
OUT dst,srce 
OUTB 
OUTD GsSit, -sreeir 
OUTDB 
OUTI dst,src,r 
OUTIB 
SIN dsit,.sre 
SINB 
SIND Gast, sre pr 
SINDB 
SINDR dst,src,r 
SINDRB 
SINI dsit, SreiG 
SINIB 
SINIR ast «src,¥F 
SINIRB 
SOTDR dst,sKre, kr 
SOTDRB 
SOTIR dst,src,r 
SOTIRB 


(continued) 


Name of Instruction 


Input, Decrement and 


Repeat 


Input and Increment 


Input, Increment and 


Repeat 


Output, Decrement and 


Repeat 


Output, Increment and 


Repeat 


Output 

Output and Decrement 
Output and Increment 
Special Input 
Special Input and 


Decrement 


Special Input, Decrement 
and Repeat 


Special Input and 
Increment 


Special Input, Increment 
and Repeat 


Special Output, Decrement 
and Repeat 


Special Output, Increment 


and Repeat 
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INPUT/OUTPUT INSTRUCTIONS (continued) 


Instruction 


SOUT 
SOUTB 


SOUTD 
SOUTDB 


SOUTI 
SOUTIB 


Instruction 


COMFLG 
DI 

EI 
HALT 


LDCTL 
LDCTLB 


LDPS 
MBIT 
MREQ 
MRES 
MSET 
NOP 
RESFLG 


SETFLG 
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Operand(s) 


dst,src 


dst,src,r 


dsttizsre, r 


Name of Instruction 
Special Output 
Special Output and 
Decrement 


Special Output and 
Increment 


CPU CONTROL INSTRUCTIONS 


Operand(s) 
flag 

int 

int 
dst,src 


sre 


dst 


flag 


flag 


Name of Instruction 
Complement Flag 
Disable Interrupt 
Enable Interrupt 
Halt 


Load Control Register 


Load Program Status 
Multi-Micro Bit) Test 
Multi-Micro Request 
Multi-Micro Reset 
Multi-Micro Set 

No Operation 

Reset Flag 


Set Flag 


The following set of instructions are privileged; that is, they 
can only be executed in System mode: 


DI INIB OTDR SIN SOTDR 
EI INIR OTDRB SINB SOTDRB 
HALT INIRB OTIR SIND SOTIR 
IN IRET OTIRB SINDB SOTIRB 
INB LDCTL OUT SINDR SOUT 

IND LDPS OUTB SINDRB SOUTB 
INDB MBIT OUTD SINI SOUTD 
INDR MREQ OUTDB SINIB SOUTDB 
INDRB MRES OUTI SINIR SOUTI 


INI MSET OUTIB SINIRB SOUTIB 


3.2 NOTATION AND BINARY ENCODING 


3.2.1 Operand Notation 


Operands are represented by a notational shorthand in the ; 
detailed instruction descriptions that make up the rest of this 
section. The notation for operands and their actual assembly 
language syntax are as follows: 


Notation Address Mode Actual Operand 
IM Immediate Data #expression 
R Register Rn, where n=0-15; 


RHn, or RLn, where 
n=0-7; RRn, where 

N=0,2:, 45 '2<% b4: ROn,, 
where n=0,4,8,12 _ 


IR Indirect Register @Rn, where n=1-15 
for nonsegmented mode; 
@RRn, where n=2,4,6...14 
for segmented mode 


DA Direct Address expression 

xX Indexed Address expression(Rn), where 
a=T=TS 

RA Relative Address expression 

BA Based Address Rn(#expression), where 


n=1-15 for nonsegmented 
mode; RRn(#expression), 
where n=2,4,6...14 for 
segmented mode 


BX Based Indexed Rn(Rn), where n=1-15 
Address for nonsegmented mode; 
RRn(Rm), where 
n=2,4,6...14 and m=1-15 
for segmented mode 
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The control registers (CTLR) are: 


FLAGS 
FCW 
REFRESH 
PSAP 
PSAPSEG 
PSAPOFF 
NSP 
NSPSEG 
NSPOFF 


Status Flags 

Flags and Control Word 

Refresh 

Program Status Area Pointer* 
Program Status Area Pointer Segment 
Program Status Area Pointer Offset 
Normal Stack Pointer* 


Normal Stack Pointer Segment 


Normal Stack Pointer Offset 


* For the nonsegmented 28002, PSAP is equivalent to PSAPOFF 
and NSP is equivalent to NSPOFF. 


The status flags are: 


moO aVHNA 


Carry flag 

zero flag 

Sign flag 

Parity flag 

Overflow flag 
Decimal-adjust flag* 
Half-carry flag* 


* These flags may not be specified in assembly language 
statements. 


The interrupt control bits are: 


VI 
NVI 


Vectored Interrupt 
Non-Vectored Interrupt 


The binary values used in the instruction format encoding for the 
general-purpose registers are: 


RQO 


RQ4 


Register 
RRO RO 
Rl 
RR2 R2 
R3 
RR4 R4 
R5 


RHO 
RH1 
RH2 
RH3 
RH4 
RH5 


Binary 


0000 
0001 
0010 
0011 
0100 
0101 
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RQ8 


RQ12 


Register 

RR6 R6 RH6 
R7 RH7 

RR8& R8 RLO 
R9 RL1 

RR10 R10 RL2 
Rll RL3 

RR12 R12 RL4 
R13 RL5 

RR14 R14 RL6 
R15 RL7 


The condition 


Code 


(blank) 
Z 


NZ 
€ 
NC 
PL 
MI 
NE 
EQ 
OV 
NOV 
PE 
PO 
GE 


LT 
GT 
LE 


UGE 


ULT 
UGT 


ULE 


Meaning 


Always false 
Always true 
Zero 

Not zero 
Carry 

No carry 
Plus 

Minus 

Not equal 
Equal 
Overflow 

No overflow 
Parity even 
Parity odd 
Greater than 
or equal 
Less than 
Greater than 
Less than or 
equal 
Unsigned 
greater than 
or equal 
Unsigned 
less than 
Unsigned 
greater than 


Unsigned less 
than or equal 


Binary 
0110 


0111 
1600 
1001 
1010 
1011 
1100 
1101 
1110 
Mie 


codes and the flag settings they represent are: 


Flag Settings Binary 


0000 
1000 
6110 
1110 
yababal 
ileikakak 
1101 
0101 
1110 
0110 
0100 
1100 
0100 
1100 
XOR V) = 0 1001 


-~UWVUVUASINNMNHNONANN ! 
CHORFORFROOHFOF 


G2 WW OW et, NO es hie 


(S XOR V) =1 0001 
(Z OR (S XOR V)) 0 1010 
(Z OR (S XOR V) ) 00610 


nou 
he 


c=0 eg baa 


C=1 0111 
((C=0) AND (z=0)) =1 1011 


(C OR Z) = 1 0011 


Note that some of the condition codes correspond to identical 


flag settings: 


i.@., Z2-EQ, 


NZ-NE, 


C-ULT, NC-UGE, PE-OV, PO-NOV. 


3.2.2 Instruction Format Encoding 


The binary encoding of each 28000 instruction follows one of nine 
basic formats. Each format determines the grouping of bits into 

various instruction "fields", the meaning of which depends on the 
instruction. The following symbols represent these fields: 


Symbol Field Size Value 
mode 2 bits Addressing mode specifier 
src Varies Source operand address or 


immediate value 


dst Varies Destination operand address 

i 4 bits Register counter address 

num 4 bits Number (immediate value) 

ee 4 bits Condition code 

W/B J. bat Word or byte specifier 

X 4 bits Index register address for Based 


Indexed Addressing mode 


displacement Varies Displacement for Relative or 
Based Addressing modes 


All other bit fields are referred to as Operation code (opcode) 
fields because they determine the operation of the instruction. 


In addition to the various fields within an instruction, address 
information for the data operands may be appended to the basic 
instruction encoding. The size and format of this additional 
address information depends on the particular address mode, as 
well as the data operand size in the case of Immediate Data, or 
the segmentation mode in the case of Direct Address or Indexed 
Address. 
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The standard formats for address information are illustrated by 
the following examples. Nonstandard formats are described in the 
detailed description for each instruction (Section 3.3). The 
following examples use Addition (ADD), Load (LD), and Load 
Relative (LDR) instructions for illustration purposes, although 
the address information formats apply to all instructions which 
require additional address information. 


Register (R) 


dst sre 
ADDR, R FG a a 
{mode = 10} 


Example: 


ADD R2,R3 FCS CCC Cd CCD CE 
Pi ae 


Immediate Data -- Word (IM) 


ADDR, IM ico a 


{mode = 00, src field = 0} 


Example: 
ADD R2,#%1234 


Immediate Data -- Byte (IM) 


dst." (sre 


appa “R, TH ree me ee, 


{mode = 00, src field = 0, Byte Immediate Data is duplicated 
in each half of the second instruction word} 


Example: 
ADDB RH2,#%12 


Immediate Data -- Long (IM) 


dst she 


ADDL RFR, [2M 


| mode | opcode src dst 
eenrreera ee et 


eS 
data (high order) 


data (low order) 


{mode = 00, src field = 0} 


Example: 
ADDL RR2,#%12345678 


Indirect Register (TR) 


dst src LYVA: *} 


app “Ry TR feo] eee ee 
CR 


{mode = 00, sre field <> 0} 


Example: 
ADD R2,@R3 


Direct Address -- Nonsegmented (DA) 


dst€ ‘sic 


address 


{mode =.01,..snc field = .0} 


Example: 
ADD R2,%0012 
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Direct Address -- Segmented Short Offset (DA) 


dst cosine 
ADD R, DA mode opcode src dst 
<= 


1 i 
0 segment offset 


{mode = 01, sre field = 0} 


Example: 
ADD R2,|<<3>>%0012| 


Direct Address -- Segmented Long Offset (DA) 
dst src 
ADD R, DA opcode 


sei 
segment 
i 


offset 


{mode = 01, src field = 0} 


Example: 
ADD R2,<<3>>%0012 


Indexed Address -- Nonsegmented (xX) 


dst-—sre 


apD Ry pee] ome lee 
Lan — 


address 


{mode = 01, src field <> 0} 


Example: 
ADD R2,%0012(R4) 


Indexed Address -- Segmented Short Offset (X) 


dst sre 


app R, x ree] ome ele 


{mode = 01, sre field <> 0} 


Example: 
ADD R2,|<<3>>%0012] (R4) [o 1] 


ie Son ae 


Example: 
ADD R2,<<3>>%0012(R4) 


Relative Address (RA) 


dst src 


LDR OR, RA ee oe 


Example: 
LDR R2,$+10 


{The assembler automatically calculates the relative address 
displacement (=6) as the given value (10 bytes after the 


Start of the . LDR instruction)! minus the start of 


following instruction (4 bytes after the start of the LDR 


instruction) } 
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Based Address (BA) 


dst sre 


LD Ry 7 ee 


{sme field -<> 0} 


Example: 
LD R2,R4(#%0012) 


Based Indexed Address (BX) 


dst src 


sre: field! <> OF 


Example: 
LD R2,R4(R5) 


opcode 'W/B src dst 
4 4 1 1 S_ 4 1 i! 


displacement 


opcode 
r peels 


There are several instructions whose source operand is Immediate 
Data and destination operand is either Direct Address or Indexed 
Address. In this case, the Immediate Data follows the address 
information (DA or X) in the-instruction encoding. The following 
example uses the nonsegmented DA format 


dst src 
LD> Dai, IM 


Example: 
LD %0012,#%1234 
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address 


Pelee et | 


The nine basic formats, Fl through F9, determine the size of the 
instruction, which also depends on the addressing mode. The 
following table can be used to determine the number of bytes in a 
particular instruction. The addressing mode (including the data 
operand size and whether segmented or nonsegmented mode is used) 
specifies the row in the table, while the format number specifies 
the column. 


TABLE 3-1. NUMBER OF BYTES IN INSTRUCTIONS 


MODE FORMAT 

dst Or sre BL BBS. 4 os. 6G FY ES: £9 
R, IR 2 2 -- -- 4 4 2 2 -- 
IM (Word/Byte) 4 4 2; —-- -- -- =-- -- 2 

IM (Long) 6 6 == == == =e ae ae =H 
DA,X (NS/SS) 4 4 -- -- 6 6 4 -—- -- 
DA,X (SL) 6 6 -- -- 8 8 -- == =- 
RA -- -- 2 4 -- = eR 
BA a 
BX a a 


NS = Nonsegmented, SS = Segmented Short Offset, SL = Segmented 
Long Offset 


3.2.3 Operation Notation 


The description of each instruction's operation includes a 
shorthand summary. The following symbols are used in the 
Operation summary. 


Symbol Meaning 
src Source operand 
dst Destination operand 
E Register operand (typically 
used as a counter) 
num Number, that is, an immediate 
value 
ce Condition code 
instruction Binary value of the instruction 
itself 
Rn Register number "n" 
Be Program Counter register 
PS Program Status register 
SP Processor stack pointer register 


(R15 if nonsegmented, RR14 
if segmented) 


<- Becomes (assignment of a value) 

@n Indirect; that is, the value 
found at the address contained 
in i 

nijn2 Concatenation; that is, both 


"nl" and "n2" are operated 
on together 


fyn Operand addressed by the 
Boolean OR of the instruction 
field "f" and the value "n" 
(eG, ROW rs RE) 
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Symbol 


operand (n) 
operand (msb) 


Operand(nl:n2) 


src[dst] 


AUTOINCREMENT 


AUTODECREMENT 


Meaning 


Bit "n" of operand 
Most significant bit of operand 


Bits “nl” schrough “n2" 
of operand 


Indexed access, that is, the 
operand whose address is 
contained in the source operand 
offset by the destination operand. 


The address of the operand is 
automatically incremented by the 
size of the operand in bytes (the 
address is always contained in a 
register) 


The address of the operand is 
automatically decremented by the 
size of the operand in bytes (the 
address is always contained in 

a register) 
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3.3 ASSEMBLY LANGUAGE INSTRUCTIONS 


In the remainder of this chapter, 28000 assembly language 
instructions are described in detail in alphabetic order. Each 
description includes: 
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The name of the instruction. 


The assembly language statement format(s) including 
the required operands and valid addressing modes (see 
SECEVON) Si.2nct)i. 


The binary instruction format(s) including the 
instruction fields and the format class (see section 
3.2.2). If the instruction has a "mode" field, then the 
valid addressing modes for that format are listed to the 
right of the binary encoding. If the instruction has a 
"W/B" field, then a "1" bit indicates a word operation and 
a "0" bit indicates a byte operation. The format class 
appears in parentheses above the binary encoding and 
consists of two numbers (Fn.m). "Fn" specifies the basic 
format class Fl through F9 and can be used with Table 3-1 
to determine the number of bytes for a particular 
instruction. The "m" portion of the format number 
specifies the sub-class (see Appendix A). 


The operation performed by the instruction including. 
a summary description (see section 3.2.3) and a detailed 
description. 


The status flags affected by the instruction. 


The number of machine cycles used to execute the 
instruction. 


Special notes for some instructions concerning 
nonstandard instruction field encodings, hardware related 
functions, operation restrictions, and other 
architectural or implementation details. 


A short assembly language example showing the use 
of the instruction. All examples assume the nonsegmented 
mode unless otherwise specified. 


ADC 


Add with Carry 


ADC dst,src dst mR: 
ADCB sre: 
INSTRUCTION FORMAT: (2.215) 


w/e:[ampe eh] Te, ] 0 RR 


OPERATION: 


FLAGS: 


CYCLES: 


EXAMPLE: 


ast <= dsti+ sre +¢c 


The source operand, along with the setting of the 


carry flag, is added to the destination operand and the 
sum is stored in the destination. The contents of the 
source are not affected. Two's complement addition is 


performed. In multiple precision arithmetic, this 
instruction permits the carry from the addition of 
low-order operands to be carried into the addition of 
high-order operands. 


Set if there is a carry from the most significant bit 
of the result; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 
Set if arithmetic overflow occurs, that is, if both 
operands were of the same sign and the result is of 
the opposite sign; cleared otherwise 

ADC - unaffected; ADCB - cleared 

ADC - unaffected; ADCB - set if there is a carry 
from the most significant bit of the low-order four 
bits of the result; cleared otherwise 


Word/Byte 
5 


Long addition may be done with the following 
instruction sequence, assuming RO,RI1 contain one 
operand and R2,R3 contain the other operand: 


ADD R1,R3 !add low-order words! 
ADC RO,R2 !add carry and high-order words! 


If RO contains $0000, Rl contains %FFFF, R2 contains 
$4320 and R3 contains %0001, then the above two 
instructions leave the value %4321 in RO and %0000 
na Rel se 
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ADD 


Add 
ADD dst,srce ds tire 
ADDB src: R, IM, WRIADA; xX 
ADDL 


INSTRUCTION FORMAT: (E219) 
mode dst src 


W/B: 0 0 000 src 10 R R 
uae) Pe Her acta 00 R IM (src field=0) 
L: of tot - th 0 src 00 R IR (sre field<>0) 
BE as 01 R DA (src field=0) 
Ol R X (sre field<>0) 


OPERATION: dst <- dst + src 


The source operand is added to the destination operand 
and the sum is stored in the destination. The contents 
of the source are not affected. Two's complement addi- 
tion is performed. 


FLAGS: C: Set if there is a carry from the most significant bit 

of the result; cleared otherwise 

Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 

V: Set if arithmetic overflow occurs, that is, if both 
operands were of the same sign and the result is of 
the opposite sign; cleared otherwise 

D: ADD,ADDL - unaffected; ADDB - cleared 

H: ADD,ADDL - unaffected; ADDB - set if there is a carry 
from the most significant bit of the low-order four 
bits of the result; cleared otherwise 


CYCLES’: Src Word/byte Long 
NS) “sS' SL NS SS SL 
R 4 -- -- 8 -- -- 
IM Jo-- -- LA ses e0e> 
IR 7o-- -- 14 -- -- 
DA 9; 440, =b2 165; g alG: ks 
xX LO oO 13 Gr M6: 09 


EXAMPLE: If register R2 contains %0344 and the word at 
the location named AUGEND contains $0011, the statement 


ADD R2,AUGEND 


will leave the value $0355 in R2. 
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AND 


And 


AND ast ssrc disits' 42: 
ANDB sre: R, IM, IR; DA, xX 


INSTRUCTION FORMAT: (F251) 


mode dst src 


W/B: | mode | 0 oo 14 1 [wel sre] ast 10 R R 
we 00 R IM (sre field=0) 
00 R IR (sre field<>0) 
O01 R DA (sre field=0) 
Ol R X (sre field<>0) 


OPERATION: 


FLAGS: Cs 


CYCLES: 


EXAMPLE: 


dst <- dst AND src 


The source operand is logically ANDed with the 
destination operand and the result is stored in the 
destination. The contents of the source are not 
affected. The AND operation results in a one bit being 
stored whenever the corresponding bits in the two 
operands are both ones; otherwise, a zero bit is stored. 


Unaffected 

Set if the result is zero; cleared otherwise 

Set if the most significant bit of the result is set; 
is even; cleared otherwise 

AND - unaffected; ANDB - set if parity of the result 
is even; cleared otherwise 

Unaffected 

Unaffected 


src Word/Byte 
NS SS SL 


R 
IM = 
IR -- 

DA ve a2 

X ig is 


If register RL3 contains %C3 (11000011) and the 
source operand is the immediate value %7B (01111011), 
the statement 

ANDB RL3,#%7B 


will leave the value %43 (01000011) in RL3. 
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BIT 


Bit Test 


BIT dst,srec ast: UR, LER, DAs «Xx 
BITB Src ik, oom 


INSTRUCTION FORMAT: (F1.2) 


weft le Toe] to Ok we 

Lil 00 IR IM (dst field<>0) 
01 DA IM (dst field=0) 
01 X IM (dst field<>0) 


OPERATION: Z <- NOT dst(src) 


Tests the specified bit within the destination operand, 
and sets the Z flag if the specified bit is 0; other- 
wise it clears the Z flag. The contents of the desti- 
nation are not affected. The source (the bit number) 
can be specified as either an immediate value, or as a 
word register which contains the value. In the second 
case, the destination operand must be a register, and 
the source operand must be RO through R7 for BITB, or 
RO through R15 for BIT. The bit number is a value 
from 0) to 7 Lor BlLBy. Or 70).. to.) > hor Bat, «waren. 10 
indicating the least significant bit. 


C: Unaffected 
Z: Set if specified bit is zero; cleared otherwise 
S: Unaffected 
V: Unaffected 
D: Unaffected 
H: Unaffected 


CYCLES: dst “sre (\Wond/Byte 
NS SS SL 

R IM Be 6 = 

aR IM Bree te SS 

DAY aEMC 7) OR i als 

yO oii) trata LS a Bs Le 

R Re kOe t= 
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BIT 


Bit Test 


NOTE: 


EXAMPLE: 


Only the lower four bits of the source operand are used 
to specify the bit number for BIT, while only the lower 
three bits of the source operand are used with BITB. 
When the source operand is an immediate value, the "src 
field" in the instruction format encoding contains the 
bit number in the lowest four bits for BIT, or the 
lowest three bits for BITB. 


If register RH2 contains %B2 (10110010), the statement 
BITB. RH2,#0 


will leave the Z flag set. 
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CALL 


Call Procedure 


CALL dst dst: IR, DA, X 


INSTRUCTION FORMAT: @F as) 


mode dst 


Peep ee] (OO OTR 


OPERATION: 


FLAGS: 


CYCLES: 


EXAMPLE: 
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01 DA (dst field=0) 
01 X (dst field<>0) 


Nonsegmented Segmented 
SP <- SP - 2 SP <- SP - 4 
@SP <- PC @SP <- PC 
PC <- dst PC <- dst 


The current contents of the program counter (PC) are 
pushed onto the top of the processor stack. The stack 
pointer used is R15 if nonsegmented, or RR14 if seg- 
Mented. (The program counter value used is the address 
of the first instruction byte following the CALL in- 
struction.) The specified destination address is then 
loaded into the PC and points to the first instruction 
of a procedure. 


At the end of the procedure a RET instruction can be 
used to return to original program flow. RET pops 
the top of the processor stack back into the PC. 


No flags affected 


dst Address 
7 NS SS SL 
IR 10 -- 15 
DA ED) alse 210 
x 13 MUS "2! 


In nonsegmented mode, if the contents of the program 
counter are %1000 and the contents of the stack 
pointer (R15) are %3002, the statement 


CALL $%2520 


causes the stack pointer to be decremented to %3000, 
the value $1004 (the address following the CALL 
instruction with direct address mode specified) to be 
loaded into the word at location %3000, and the program 
counter to be loaded with the value %2520. The program 
counter now points to the address of the first 
instruction in the procedure to be executed. 


CALR 


Call Procedure Relative 


CALR dst dst: RA 


INSTRUCTION FORMAT: (F3.4) 


i +.0 4 displacement RA 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


dst 


Nonsegmented Segmented 

SP <- SP - 2 SP <- SP - 4 

@SP <- PC @SP <- PC 

PC <- PC - (2*disp) PC <- PC - (2*disp) 


The current contents of the program counter (PC) are 
pushed onto the top of the processor stack. The stack 
pointer used is R15 if nonsegmented, or RR14 if seg- 
mented. (The program counter value used is the address 
of the first instruction byte following the CALR in- 
struction.) The destination address is calculated and 
then loaded into the PC and points to the first in- 
struction of a procedure. 

At the end of the procedure a RET instruction can be 
used to return to the original program flow. RET pops 
the top of the processor stack back into the PC. 


No flags affected 


Address 
NS SS SL 
10 -- 15 


The relative addressing mode is calculated by doubling 
the displacement in the instruction, then subtracting 
this value from the updated value of the PC to derive 
the destination address. The updated PC value is taken 
to be the address of the instruction byte following the 
CALR instruction, while the displacement is a 12-bit 
signed value in the range -2048 to +2047. Thus, the 
destination address must be in the range -4092 to +4098 
bytes from the start of the CALR instruction. In the 
segmented mode, the PC segment number is not affected. 
The assembler automatically calculates the displacement 
by subtracting the PC value of the following instruction 
from the address given by the programmer. 


CALR PROC !Procedure PROC is called! 
NEXT: !Control eventually returns to here! 
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CLR 


Clear 
CLR dst dst: R,.LR,ebDAy, X 
CLRB 
INSTRUCTION FORMAT: (BLL) 
mode dst 
W/B:[mede[o 0,1, +o fwe] | ast [+0 9,9) LO 1-B 
00 IR 
01 DA (dst field=0) 
01 X (dst field<>0) 
OPERATION: dst <- 0 
The destination is cleared to zero. 
FLAGS: No flags affected 
CYCLES: dst Word/Byte 
NS ESS. con 
R J o—<- = 
IR ee. 
DA IT; B26 124 
xX Dee p15 
EXAMPLE: If the word at location %ABBA contains 13, the 
; statement 
CLR %ABBA 


will leave the value 0 in the word at location %ABBA. 
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COM 


Complement 
com | - at’ * dst: R, IR, DA, X 
COMB 
INSTRUCTION FORMAT: (F1.1) 


mode dst 
w/B:[meeTo oe el et eee] 6 TO 
0 IR 
Ol DA (dst field=0) 
Ol X (dst field<>0) 


OPERATION: dst. “<= NOT “dst 


The contents of the destination are complemented (one's 
complement); all one bits are changed to zero, and vice- 
versa. 
FLAGS: C: Unaffected 
Z: Set if the result is zero; cleared otherwise 
S: Set if the most significant bit of the result is set; 
cleared otherwise 
P; COM — unakftecteds COMB’ = set 1f parity of ‘the result 
is even; cleared otherwise 
D: Unaffected 
H: Unaffected 


CYCLES: dst Word/Byte 
NS SS SL 


R 7 -- -- 
IR ee 
DA Le” 16" 8 
X 16°16 19 


EXAMPLE: If register Rl contains $2552 (0010010101010010), 
the statement 


COM Rl 


will leave the value %DAAD (1101101010101101) in Rl. 
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COMFLG 


Complement Flag 


COMFLG flag Flags, Cpr, Sr Pr V 


INSTRUCTION FORMAT: (F9.1) 


OPERATION: 


CYCLES: 


EXAMPLE: 
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FLAGS(4:7) <- FLAGS(4:7) XOR instruction(4:7) 


Any combination of the C, Z, S, P or V flags are 
complemented (each one bit is changed to zero, and 
vice-versa) if the corresponding bit in the 
instruction is one. If the corresponding bit in the 
instruction is zero, the flag will not be affected. 
All other bits in the FLAGS register are 
unaffected. Note that the P and V flags are 
represented by the same bit. There may be one, 
two, three or four operands in the assembly 
language statement, in any order. 


Complemented if specified; unaffected otherwise 
Complemented if specified; unaffected otherwise 
Complemented if specified; unaffected otherwise 
Complemented if specified; unaffected otherwise 
Unaffected 

Undefined 
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If the C, Z, and S flags are.all clear (=0), 
and the P flag is set (=1), the statement 


COMFLG P, S, Z, C 


will leave the C, Z, and S flags set (=1l), 
and the P flag cleared (=0). 


cP 


Compare 
CP dst,src dst: R; IR, DA, x 
CPB Sree! RA IM, RG) DA, X 
CPL 
INSTRUCTION FORMAT: (@ 7am) 
mode dst src 
w/B:[mee[oe te le, [ee] jl RF OR 
ihe 00 R IM (sre field=0) 
Pe 0) eS) a ee eee 
Ol R X (sre field<>0) 
(5: 1) 
mode dst src 
w/e:[re@lo oe] et, [eee] 400 OTR ON 
Ol DA IM (dst field=0) 
Ol x IM (dst field<>0) 


OPERATION: 

FLAGS: Cz 
ZS 
a2 
Ve 
be 
He 

CYCLES: 


dst —- src 


The source operand is compared to (subtracted from) the 
destination operand, and the appropriate flags set 
accordingly, which may then be used for arithmetic and 
logical conditional jumps. Both operands are unaffect- 
ed, with the only action being the setting of the flags. 
Subtraction is performed by adding the two's complement 
of the source operand to the destination operand. 


Cleared if there is a carry from the most significant 
bit of the result; set otherwise, indicating a "borrow" 
Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 

Set if arithmetic overflow occurs, that is:, 1£ both 
operands were of opposite signs and the sign of the 
result is the same as the sign of the source; cleared 
otherwise 

Unaffected 


Unaffected 
dst sre Word/Byte Long 
NS SS SL NS SS SL 
R R Bi le Bi Sse. =e 
R IM i” == Ika es eS 
R IR NS ibage ce a La == Se 
R DA 9 10 22 im 26 18 
R X LG alo 3 16 16 129 
IR IM id: = == Sa Se SS 
DA IM Va he == Se (= 
X IM is 2 as = == == 
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CP 


Compare 


EXAMPLE: 
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If register R5 contains 30400, the byte at location 
30400 contains 2, and the source operand is the 
immediate value 3, the statement 


CPB @R5,#3 


will leave the C flag set, indicating a borrow, the 
S flag set, and the Z and V flags cleared. 


CPD 


Compare and Decrement 


CPD dst. ~<SHG, 6, ce dist: sR 
CPDB sre: IR 
INSTRUCTION FORMAT: (F6.5) 


OPERATION: 
FLAGS: «-€s 
Zs 
Sis 
Ve 
Ds 
H: 
CYCLES: 
EXAMPLE: 


dst - sre 
AUTODECREMENT src {-l if byte, -2 if word} 
r<-r-l 


This instruction is used to search a string of data for 
an element meeting the specified condition. The con- 
tents of the location addressed by the source register 

is compared to (subtracted from) the destination operand, 
and the Z flag is set if the condition code specified by 
"cc" would be set by the comparison; otherwise the Z flag 
is cleared. See section 3.2.1 for a list of condition 
codes. Both operands are unaffected. 


The source register is then decremented by one if CPDB, 
or by two if CPD, thus moving the pointer to the pre- 
vious element in the string. The word register specified 
by "r" (used as a counter) is then decremented by one. 


Undefined 

Set if the condition code generated by the comparison 
matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
20 


If register RHO contains @FF, register Rl contains 
34001, the byte at location %4001 contains %00, and 
register R3 contains 5, the statement 

CPDB RHO,@R1,R3,EQ 
will leave the Z flag cleared since the condition code 


would not have been "equal". Register R1 will contain 
the value %4000 and R3 will contain 4. 
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CPDR 


Compare, Decrement and Repeat 


EPDR dst,sne sr rec dsts 2R 
CPDRB sre: IR 
INSTRUCTION FORMAT: (F6.5) 
dSt Usnc, 1 
R IR R 


OPERATION: 

FLAGS: C: 
Zi 
S: 
V: 
De 
He 

CYCLES: 
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dst - sre 
AUTODECREMENT src {-l if byte, -2 if word} 
yr <=r-= 1 


repeat until cc is true or r = 0 


This instruction is used to search a string of data for 
an element meeting the specified condition. The con- 
tents of the location addressed by the source register 

is compared to (subtracted from) the destination operand, 
and the Z flag is set if the condition code specified by 
"cc" would be set by the comparison; otherwise the Z flag 
is cleared. See section 3.2.1 for a list of condition 
codes. Both operands are unaffected. 


The source register is then decremented by one if CPDRB, 
or by two if CPDR, thus moving the pointer to the pre- 
vious element in the string. The word register speci- 
fied by "r" (used as a counter) is then decremented by 
one. The entire operation is repeated until either the 
condition is met or the result of decrementing r is 
zero. This instruction can search a string from 1 to 
65536 bytes or 32768 words long (the value of r must 

not be greater than 32768 for CPDR). 


Undefined 

Set if the condition code generated by the comparison 
Matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
11+9*n (n=number of data elements compared) 


CPDR 


Compare, Decrement and Repeat 


NOTE: 


EXAMPLE: 


This instruction can be interrupted after each execution 
of the basic operation. The program counter value of 
the start of this instruction is saved before the 
interrupt request is accepted, so that the instruction 
can be properly resumed. Seven more cycles should be 
added to this instruction's execution time for each 
interrupt request that is accepted. 


If the string of words starting at location %2000 | 

contain the values 0,2,4,6 and 8, register R2 contains 

$2008, R3 contains 3, and R8 contains 8, the statement 
CPDR R3,@R2,R8,GT 

will leave the Z flag set indicating the condition was 


met. Register R2 will contain the value 2000, R3 will 
still contain 3, and R8 will contain 4. 
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CPI 


Compare and Increment 


CPI GS. SUC, Gb icc dsts 2 
CPIB Ses JER 


INSTRUCTION FORMAT: (F6.5) 


i 
we:fe eh], [ee] oR TR 
Beato] t ebstiesds ai aed 


OPERATION: dist = SEC : : 
AUTOINCREMENT src {+l if byte, +2 if word} 
Tne acetal: 


This instruction is used to search a string of data for 
an element meeting the specified condition. The con- 
tents of the location addressed by the source register 

is compared to (subtracted from) the destination operand, 
and the Z flag is set if the condition code specified by 
"cc" would be set by the comparison; otherwise the Z flag 
is cleared. See section 3.2.1 for a‘list of condition 
codes. Both operands are unaffected. 


The source register is then incremented by one if CPIB, 
or by two if CPI, thus moving the pointer to the next 
element in the string. The word register specified by 
"r" (used as a counter) is then decremented by one. 


Undefined 

Set if the condition code generated by the comparison 

Matches cc; cleared otherwise 

S: Undefined 

V: Set if the result of decrementing r is zero; cleared 
otherwise 

D: Unaffected 

H: Unaffected 


FLAGS: C 
Z 


CYCLES: Word/Byte 
20 
EXAMPLE: This instruction is used in a "loop" of instructions 


which searches a string of data for an element meeting 
the specified condition, but an intermediate operation 
on each data element is required. The following se- 
quence "scans while numeric", that is, a string is 
searched until either an ASCII character not in the 
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CPI 


Compare and Increment 


range "0" to "9" (see Appendix) is found, or the end 
of the string is reached. This involves a range check 
on each character (byte) in the string. 


LD R3,#STRLEN !Initialize counter! 

LD R1,#STRSTART !Load start address! 

LD RLO,#'9' !Largest numeric char! 
LOOP: 

CPB @R1,#'0O' ITest..char < ‘O"! 

JR ULT , NONNUMERIC 

CPIB RLO,@R1,R3,ULT 'Test char > '9'! 

JR Z ,NONNUMERIC 

JR NOV, LOOP !Repeat until counter=0! 
DONE: - 
NONNUMERIC: !Handle non-numeric char! 
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CPIR 


Compare, Increment and Repeat 


CPLR «dst, src,r,.ce dst: R 
CPIRB Src:: ER 


INSTRUCTION FORMAT: (F653) 


“ 
laf 
‘ 
pons 


OPERATION: 
FLAGS: C: 
digs 
Ss 
Ve 
D: 
H: 
CYCLES: 
NOTE: 
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dst-- sre ; 

AUTOINCREMENT src {+l if byte, +2 if word} 
Te gees ome 

repeat until ce cis, cnue Jor 1 = 0 


This instruction is used to search a string of data for 
an element meeting the specified condition. The con- 
tents of the location addressed by the source register 

is compared to (subtracted from) the destination operand, 
and the Z flag is set if the condition code specified by 
"cc" would be set by the comparison; otherwise the Z flag 
is cleared. See section 3.2.1 for a list of condition 
codes. Both operands are unaffected. 


The source register is then incremented by one if CPIRB, 
or by two if CPIR, thus moving the pointer to the next 
element in the string. The word register specified by 
"yr" (used as a counter) is then decremented by one. 

The entire operation is repeated until either the con- 
dition is met or the result of decrementing r is zero. 
This instruction can search a string from 1 to 65536 
bytes or 32768 words long (the value of r must not be 
greater than 32768 for CPIR). 


Undefined 

Set if the condition code generated by the comparison 
matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 


11+9*¥n (n=number of data elements compared) 


This instruction can be interrupted after each 
execution of the basic operation. The program counter 
value of the start of this instruction is saved 


CPIR 


Compare, Increment and Repeat 


EXAMPLE: 


before the interrupt request is accepted, so that the 
instruction can be properly resumed. Seven more cycles 
should be added to this instruction's execution time 
for each interrupt request that is accepted. 


The following sequence of instructions can be used to 
search a string for an ASCII return character. The 

pointer to the start of the string is set, the string 
length is set, the character (byte) to be searched for 
is set, and then the search is accomplished. Testing 
the Z flag determines whether the character was found. 


LD R1,#STRSTART 
LD R3,#STRLEN 

LD RLO,#'%R' 
CPIRB RLO,@R1,R3,EQ 
JR Z, FOUND 
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CPSD 


Compare String and Decrement 


CPSD .dst,srce,r,cc dst: IR 
CPSDB srcito TR 


INSTRUCTION FORMAT: (P6255) 


Qu 
n 
ct 
n 
n 
Q 


| 
| 


ve} 
e. 
ve) 
mln 


OPERATION: 


FLAGS: C: 
Z 


CYCLES: 


EXAMPLE: 


TL2 


dst - src 
AUTODECREMENT dst and src {-l if byte, -2 if word} 
r<=re-1 


This instruction is used to compare two strings of data 
until the specified condition is true. The contents of 
the location addressed by the source register is com- 
pared to (subtracted from) the contents of the location 
addressed by the destination register. The Z flag is 
set if the condition code specified by "cc" would be 
set by the comparison; otherwise the Z flag is cleared. 
See section 3.2.1 for a list of condition codes. Both 
Operands are unaffected. 


The source and destination registers are then decrement- 
ed by one if CPSDB, or by two if CPSD, thus moving the 
pointers to the previous elements in the strings. The 
word register specified by "r" (used as a counter) is 
then decremented by one. 


Undefined 

Set if the condition code generated by the comparison 
Matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
25 


If register R2 contains %2000, the byte at location 
$2000 contains %FF, register R3 contains %3000, the 
byte at location %3000 contains %00, and register R4 
contains 1, the statement 


CPSD 


Compare String and Decrement 


CPSDB @R2,@R3,R4,UGE 


will leave the Z flag set since the condition code would 
have been “unsigned greater than or equal", and the V 
flag will be set to indicate that the counter R4 

now contains 0. R2 will contain $1FFF, and R3 will 
contain %2FFF. : 
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CPSDR 


Compare String, Decrement and Repeat 


CPSDR dst,sre,r,cc ast: IR 
CPSDRB sree TR 
INSTRUCTION FORMAT: (F6.5) 


OPERATION: 


FLAGS: C: 


CYCLES: 
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H 
eS) 
H 
4 
zn 


dst - sre 

AUTODECREMENT dst and src {-1 if byte, -2 if word} 
re <r =cL 

repeat until cc is true or r = 0 


This instruction is used to compare two strings of data 
until the specified condition is true. The contents of 
the location addressed by the source register is com- 
pared to (subtracted from) the contents of the location 
addressed by the destination register. The Z flag is 
set if the condition code specified by "cc" would be 
set by the comparison; otherwise the Z flag is cleared. 
See section 3.2.1 for a list of condition codes. Both 
operands are unaffected. 


The source and destination registers are then decrement- 
ed by one if CPSDRB, or by two if CPSDR, thus moving the 
pointers to the previous elements in the strings. The 
word register specified by "r" (used as a counter) is 
then decremented by one. The entire operation is repeat- 
ed until either the condition is met or the result of 
decrementing r is zero. This instruction can compare 
strings from 1 to 65536 bytes or 32768 words long (the 
value of r must not be greater than 32768 for CPSDR). 


Undefined 

Set if the condition code generated by the comparison 
matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
114+14*n (n=number of data elements compared) 


NOTE: 


EXAMPLE: 


CPSDR 


Compare String, Decrement and Repeat 


This instruction can be interrupted after each execution 
of the basic operation. The program counter of the 
Start of this instruction is saved before the interrupt 
request is accepted, so that the instruction can be 
properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 


If the words from location 1000 to %1006 contain the 
values 0,2,4, and 6, the words from location %2000 to 
$2006 contain the values 0,1,1,0, register R13 con- 
tains $1006, register R14 contains %2006, and register 
RO contains 4, the statement 


CPSDR @R13,@R14,R0,EQ 
leaves the Z flag set since the condition code would 
have been "equal" (locations %1000 and %2000 both 


contain the value 0). R13 will contain %OFFE, R14 
will contain $1FFE, and RO will contain 0. 
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CPSI 


Compare String and Increment 


INSTRUCTION FORMAT: 


CPSI 
CPSIB 


dsitty SECG,r,cc 


(F6.5) 


OPERATION: 
FLAGS: C: 
2: 
Ss 
Ws 
Dis 
Hi 
CYCLES: 
EXAMPLE: 
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dst - 
AUTOINCREMENT dst and src 
Po<=.r° Hal 


src 
{tl-iff byte, +2 1f word} 


This instruction is used to compare two strings of data 
until the specified condition is true. The contents of 
the location addressed by the source register is com- 
pared to (subtracted from) the contents of the location 
addressed by the destination register. The Z flag is 
set if the condition code specified by "cc" would be 
set by the comparison; otherwise the Z flag is cleared. 
See section 3.2.1 for a list of condition codes. Both 
operands are unaffected. 


The source and destination registers are then increment- 
ed by one if CPSIB, or by two if CPSI, thus moving the 
pointers to the next elements in the strings. The 
word register specified by "r" (used as a counter) 
then decremented by one. 


is 


Undefined 

Set if the condition code generated by the comparison 
matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
25 


This instruction is used in a "loop" of instructions 
which compares two strings until the specified con- 
dition is true, but where an intermediate operation on 
each data element is required. The following sequence 
attempts to match a given source string to the destin- 
ation string which is known to contain all upper-case 
characters. The match should succeed even if the source 


CPSI 


Compare String and Increment 


string contains some lower-case characters. This in- 
volves a forced conversion of the source string to upper- 
case (only ASCII alphabetic letters are assumed, see 
Appendix) by resetting bit 5 of each character (byte) 
before comparison. 


LD R1,#SRCSTART !Load start addresses! 
LD R2,#DSTSTART 
LD R3,#STRLEN !Initialize counter! 
LOOP: 
RESB @R1,#5 !Force upper-case! 
CPSIB @R1,@R2,R3,NE !Compare until not equal! 
JR Z,NOTEQUAL !Exit loop if match fails! 
JR NOV,LOOP !Repeat until counter=0! 
DONE: : 'Match succeeds! 
NOTEQUAL: !'Match fails! 
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CPSIR 


Compare String, Increment and Repeat 


CPSIR 4 -disit,.sire., apace dst: IR 

CPSIRB sre, ER 
INSTRUCTION FORMAT: (F6.5) 

dst src 


OPERATION: 


FLAGS: C: 


CYCLES: 
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dst -— src 

AUTOINCREMENT dst and src {+1 if byte, +2 if word} 
Tis ur’ <= wh 

repeat until cc is true or r = 0 


This instruction is used to compare two strings of data 
until the specified condition is true. The contents of 
the location addressed by the source register is com- 
pared to (subtracted from) the contents of the location 
addressed by the destination register. The Z flag is 
set if the condition code specified by "cc" would be 
set by the comparison; otherwise the Z flag is cleared. 
See section 3.2.1 for a list of condition codes. Both 
Operands are unaffected. 


The source and destination registers are then increment- 
ed by one if CPSIRB, or by two if CPSIR, thus moving the 
pointers to the next elements in the strings. The 

word register specified by "r" (used as a counter) is 
then decremented by one. The entire operation is repeat- 
ed until either the condition is met or the result of 
decrementing r is zero. This instruction can compare 
strings from 1 to 65536 bytes or 32768 words long (the 
value of r must not be greater than 32768 for CPSIR). 


Undefined 

Set if the condition code generated by the comparison 
matches cc; cleared otherwise 

Undefined 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 


11+14*n (n=number of data elements compared) 


NOTE: 


EXAMPLE: 


CPSIR 


Compare String, Increment and Repeat 


This instruction can be interrupted after each execution 
of the basic operation. The program counter of the 
start of this instruction is saved before the interrupt 
request is accepted, so that the instruction can be 
properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 


The following sequence of instructions can be used to 
compare two strings of possibly different lengths, 

but at least one character (byte) long. It determines 
if the destination string is lexicographically greater 
than or equal to the source string as determined by the 
ordering of the ASCII character set (See Appendix). 
Notice that the string "ABC" is greater than "AB", and 
"AC" is greater than "ABC". The destination string is 
initially pointed to by Rl, with its length in bytes in 
R3. The source string is initially pointed to by R2, 
with its length in bytes in R4. 


CP R3,R4 !Find shortest length! 

JR ULE , COMPARE 

LD R3,R4 !IT£ source is shorter,! 

EX R1,R2 !then swap pointers! 
COMPARE: 

CPSIRB @R1,@R2,R3,ULT !Compare while >=! 

JR Z,FAIL 
SUCCEED: ; !Destination >= source! 
FAIL: !Destination < source! 
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DAB 


Decimal Adjust 


Decimal Adjust 
DAB dst dst: R 


INSTRUCTION FORMAT: (F1.1) 


7 Cac OCCA PC CPC 


OPERATION: dst <- DA dst 


The destination byte is adjusted to form two 4-bit BCD 
digits following an addition or subtraction operation. 
For addition (ADDB,ADCB) or subtraction (SUBB,SBCB) , 
the following table indicates the operation 

performed: 


Carry Number 
Before Before Added 
Instruction |} DAB DAB To Byte 


BPRERPREPFrOOO 


O=9 
A-F 
0-3 
0=9 
A-F 
0=3 
O=9 
A-F 


Sore 


0 0 
0 0 
0 1 
0 0 
0 0 
0 it 
a 0) 
Ht 0 
0 0 
0 1 
Al 0 
1 ik 


The operation is undefined if the destination byte was 
not the result of a valid addition or subtraction of 


BED digits. 
FLAGS: C: Set or cleared according to the table above 

Z: Set if the result is zero; cleared otherwise 

S: Set if the most significant bit of the result is set; 
cleared otherwise 

V: Unaffected 

D: Unaffected 

H: Unaffected 


CYCLES Byte 
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DAB 


Decimal Adjust 


EXAMPLE: If addition is performed using the BCD values 15 and 
27, the result should be 42. The sum is incorrect, 
however, when the binary representations are added 
in the destination location using standard binary 
arithmetic. 


0001 0101 
TOOT R Ole 
0011 1100 = %3C 


The DAB instruction adjusts this result so that the 
correct BCD representation is obtained. 


0011 1100 


~ 0100 0010 = 42 
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DEC 


Decrement 
DEC dst, src dst: R, LR, DA, x 
DECB sre: IM 
INSTRUCTION FORMAT: (F1.2) 


we:feele pl, eT, )] fo Rk 


OPERATION: 
FLAGS: ‘Cs 
“is 
Ss 
Vis 
D: 
He: 
CYCLES 
NOTE: 
EXAMPLE: 
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01 DA IM (dst field=0) 
01 4 IM (dst field<>0) 


dst <-.dst.- src. {sre is 1 to 16} 


The source operand (a value from 1 to 16) is subtract- 
ed from the destination operand and the result is 

stored in the destination. Subtraction is performed by 
adding the two's complement of the source operand to the 
destination operand. The source operand may be omitted 
from the assembly language statement and thus defaults 
to the value l. 


Unaffected 

Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 

Set if arithmetic overflow occurs, that is, the 

sign of the destination was opposite the sign of the 
result; cleared otherwise 


Unaffected 
Unaffected 
dst Word/Byte 
a NS SS SL 
R 4 -- -- 
IR i. == == 
DA SP, ls ANG 
xX A ae 7 


The "src field" in the instruction format encoding 
contains the source operand. The "src field" values 
range from 0 to 15 corresponding to the source values 
1 sto, Libr. 
If register R10 contains %002A, the statement 

DEC R10 


will leave the value %0029 in RIO. 


DI 


Disable Interrupt 


DiS —tnit ims “Vib, NVI 


INSTRUCTION FORMAT: (B92) 


OPERATION: 


FLAGS: 
CYCLES: 
NOTE: 


EXAMPLE: 


0 then NVI <- O 
O) then avi <=) 0 


if instruction(0) 
Lf instruction (1) 


tow 


Any combination of the Vectored Interrupt (VI) or 
Non-Vectored Interrupt (NVI) control bits in the 
Flags and Control Word (FCW) are cleared to zero if 
the corresponding bit in the instruction is zero, 
thus disabling the appropriate type of interrupt. 
If the corresponding bit in the instruction is one, 
the control bit will not be affected. All other 
bits in the FCW are not affected. There may be one 
or two operands in the assembly language statement, 
in either order. 


No flags affected 
if 
This is a privileged instruction. 


If both the NVI and VI control bits are 
set (=l), the statement 


DI «VI 


will leave the NVI control bit set (=1), 
and the VI control bit cleared (=0). 
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DIV 


Divide 


DIV dst,src dst: R 
DIVL Sires, 2OM sik DA.) x 


INSTRUCTION FORMAT: (E22) 


mode dst src 


ag) RTC as ae cee 
sia | AS ra a ee oe teenies 
L: oO 4 a iO Ao 00 R IR (src field<>0) 
Fi pee alts Ors ih) ni ous dint, BR fe eee 
01 R X (sre field<>0) 


OPERATION: 


FLAGS: 
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Word 

dst,dstyl <- dst,dstyl / src 
{dst <- remainder 

dstyl <- quotient} 


Lon 

dst,dstvl,dsty2,dstyv3 <- dst,dstyl,dsty2,dsty3 / 
sro,sreyl 

{dst,dstyl <- remainder 

dsty2,dsty3 <- quotient} 


The destination operand (dividend) is divided by the 
source operand (divisor), the quotient is stored in the 
low-order half of the destination and the remainder is 
stored in the high-order half of the destination. The 
contents of the source are not affected. Both operands 
are treated as signed, two's complement integers and 
division is performed so that the remainder is of the 
same sign as the dividend. For DIV, the destination is 
a register pair and the source is a word value; for 
DIVL, the destination is a register quadruple and the 
source is a long word value. 


DIV - set if quotient is less than -2'° or not less than 
2's cleared otherwise; DIVL - set if quotient is less 
than -2°' or not less than 2°'; cleared otherwise 

Set if the quotient or divisor is zero; cleared 
otherwise 

Set if the quotient is negative; cleared otherwise 
(contains the sign of the divisor if the instruction 
is aborted) 

Set if the divisor is zero or if the quotient would 

be too large to fit in the low-order half of the 
destination operand (the instruction is aborted if the 
absolute value of the high-order half of the dividend 
is larger than the absolute value of the divisor); 
cleared otherwise 

Unaffected 

Unaffected 


DIV 


Divide 
CYCLES: src Word Long 
NS Ss SL NS ss SL 
R 95 =-- -- 123 -- -- 
IM 95 i -- 723 = a 
IR 95 a = 723 -- -- 
DA 96 97 99 MEAN 25 jadi 27 
X 97 o7 LOO 125° “f25 “728 
(Divisor is zero) 
R ifs) == =- 30 c= == 
IM rs == =s 30 a= ae 
IR 13 == == 30 == -- 
DA 14 PS 17 Bill 32 34 
X 15 5 18 32 B2 35 
(Absolute value of the high-order half of the 
dividend is larger than the absolute value of 
the divisor) 
R 25 -- -- cyl -- -- 
IM 25 == == Sil == = 
IR 25 -- -- Bull -- -- 
DA 26 29. 28 52 5g 55 
X x4 27 29 53 53 56 
NOTE: For proper instruction execution, the "dst field" in 
the instruction format encoding must be even for DIV, 
and must be a multiple of 4 (0,4,8,12) for DIVL. ie 
the source operand in DIVL is a register, the “sire 
field" must be even. 
EXAMPLE: If register RRO (composed of word registers RO and R11) 


contains %00000022 and register R3 contains 6, the 
statement 


DIV RRO,R3 


will leave the value %00040005 in RRO (R1 contains 
the quotient 5 and RO contains the remainder 4). 
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DJNZ 


Decrement and Jump if Not Zero 


DJNZ r,dst dst: RA 

DBJNZ 
INSTRUCTION FORMAT: (F3.1) 

1g dst 
7-7 CE 
OPERATION: Beir. = Th 
if r <> 0 then PC <- PC.-3(2#disp) 
The register being used as a counter is decremented. If 


the contents of the register are not zero after decrement— 
ing, the destination address is calculated and then 

loaded into the program counter (PC). Control will then 
pass to the instruction whose address is pointed to by 

the PC. When the register counter reaches zero, control 
falls through to the instruction following DJNZ or DBJUNZ. 
This instruction provides a simple, efficient method of 
loop control. 


FLAGS: No flags affected 
CYCLES: Word/Byte 
NOTE: The relative addressing mode is calculated by doubling 


the displacement in the instruction, then subtracting 
this value from the updated value of the PC to derive 
the destination address. The updated PC value is taken 
to be the address of the instruction byte following the 
DJNZ or DBJNZ instruction, while the displacement 1s a 
7-bit positive value in the range 0 to 127. Thus, the 
destination address must be in the range -252 to 2 bytes 
from the start of the DJNZ or DBJNZ instruction. In the 
segmented mode, the PC segment number is not affected. 
The assembler automatically calculates the displace- 
ment by subtracting the PC value of the following 
instruction from the address given by the programmer. 
Note that DJNZ or DBJNZ can not be used to transfer 
control in the forward direction. 


EXAMPLE: DJNZ and DBJNZ are typically used to control a "loop" 


of instructions. In this example, 100 bytes are moved 
from one buffer area to another, and the sign bit of 
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each byte is cleared to zero. 


as the counter. 


LDB 
LD 
LD 
LOOP: 
LDB 
RESB 
LDB 
INC 
INC 
DBJNZ 
NEXT: 


RHO, #100 
R1,#SRCBUF 
R2,#DSTBUF 


RLO, @R1 
RLO,#7 
@R2,RLO 
R1- 

R2 

RHO, LOOP 


DJNZ 


Decrement and Jump if Not Zero 


Register RHO is used 


!Initialize counter! 
!Load start addresses! 


!Load source byte! 
!Mask off sign bit! 
!'Store into destination! 
!Advance pointers! 


!Repeat until counter=0! 
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EI 


Enable Interrupt 


BE . int ints) Vi p4 NVA 


INSTRUCTION FORMAT: (F9.2) 


OPERATION: 


FLAGS: - 
CYCLES: 
NOTE: 


EXAMPLE: 
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if instruction(0) = 
if anstruction(1) = 0-.then,.. VI. <=, 1 


0 then NVI <- 1 


Any combination of the Vectored Interrupt (VI) or 
Non-Vectored Interrupt (NVI) control bits in the 
Flags and Control Word (FCW) are set to one if the 
corresponding bit in the instruction is zero, thus 
enabling the appropriate type of interrupt. If the 
corresponding bit in the instruction is one, the 
control bit will not be affected. All other bits 
in the FCW are not affected. There may be one or 
two operands in the assembly language statement, in 
either order. 


No flags affected 
7 
This is a privileged instruction. 


T£ the NVI control bit is set (=1), and 
the VI control bit is clear (=0), the statement 


EI NVI,VI 


will leave both the NVI and VI control 
bits set (=l). 


EX 


Exchange 
EX dst,sre ast: RF 
EXB src: R, IR, DAy ys 
INSTRUCTION FORMAT: (F2.1) 
mode st. 7sxne 
w/s:[eem[s «1 Ope ooo a |e UU 
R IR 
Ol RDA (sre field=0) 
01 R xX (sre £Lreld<>0) 
OPERATION: tmp <- src {tmp is an internal register} 
sre <= dst 
dst <- tmp 


The contents of the source operand are exchanged with 
the contents of the destination operand. 


FLAGS: No flags affected 
CYCLES: Src Word/Byte 
NS) (SS7 asi 
R 6) E-seb-a 
IR 12) iesebsrsr 
DA 15 26: 2s 
X 16a Dosa lo 
EXAMPLE: If register RO contains 8 and register R5 contains 9, 


the statement 
EX RO,R5 


will leave the values 9 in RO, and 8 in R5. 
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EXTS 


Extend Sign 


EXTS dst dst: R 
EXTSB 
EXTSL 


INSTRUCTION FORMAT: CFLSD) 


OPERATION: Byte 
if dst(7)=0 then dst(8:15) <- 000...000 
else dst(8:15) <- 111...111 


Word 
if dstyl(15)=0 then dst(16:31) <- 000...000 
else dsit(L6331) <- 121...191 


Lon 


if dsty2,dstvy3(31)=0 then dst,dsty1(32:63) <- 000...000 
else dst, dstwv1(32:63) <= 111...111 


The sign bit of the low-order half of the destination 
operand is copied into all bit positions of the high-order 
half of the destination. For EXTSB, the destination is a 
word register; for EXTS, the destination is a register 
pair; for EXTSL, the destination is a register quadruple. 
This instruction is useful in multiple precision arith- 
metic or for conversion of small signed operands to 

larger signed operands. 


FLAGS: No flags affected 
CYCLES: Word/Byte Long 
T1 
NOTE: For proper instruction execution, the "dst field" in 


the instruction format encoding must be even for EXTS, 
and must be a multiple of 4 (0,4,8,12) for EXTSL. 


EXAMPLE: If register pair RR2 (composed of word registers R2 
and R3) contains %12345678, the statement 


EXTS RR2 


will leave the value %00005678 in RR2 (because the sign 
bit of R3 was’ 0). 


130 


HALT 


Halt 


HALT 


INSTRUCTION FORMAT: (B9).3) 


OPERATION: 


FLAGS: 


CYCLES: 


NOTES: 


The CPU operation is suspended until an interrupt 
or reset request is received. This instruction is 
used to synchronize the 28000 with external events, 
preserving its state until an interrupt or reset 
request is honored. After an interrupt is 
serviced, control falls through to the instruction 
following the HALT. 


No flags affected 

8+3*n (Interrupts are recognized at the end of 
each 3-cycle period; thus n=number of 
periods without interruption) 


This is a privileged instruction. 


While in the halt state, memory refresh cycles will 
still occur, and BUSRO will be honored. 
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IN 


Input 
IN dst,srce dst: ® 
INB sre: IR, DA 
INSTRUCTION FORMAT: (BT <3) 
dst src 
we: he, Te, | oR IR 
(P7<1L) 
dst src 
W/B:[o 0,4, 4 1,0, 3 [wo] ast [oto 0] By ee 
OPERATION: dst <= src 
The contents of the source operand are loaded into the 
destination. I/O addresses are always 16 bits. 
FLAGS: No flags affected 
CYCLES: src Word/Byte 
IR 10 
DA 12 
NOTE: This is a privileged instruction. 


EXAMPLE: If register R6 contains the I/O address %0123, and the 
"port" $0123 contains @FF, the statement 


INB RH2,@R6 


will leave the value @FF in register RH2. 
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INC 


Increment 
INC dst,src dsit< Ry ck DAG ax 
INCB src: IM 
INSTRUCTION FORMAT: (E152) 
mode St. sre 
w/s:[eel hl, ee, | (te OR 
00 IR IM 
Ol DA IM (dst field=0) 
01 xX IM (dst field<>0) 
OPERATION: dst <- dst + sre {sre is 1 to 16} 


The source operand (a value from 1 to 16) is added to 
the destination operand and the sum is stored in the 
destination. Two's complement addition is performed. 
The source operand may be omitted from the assembly 
language statement and thus defaults to the value l. 

FLAGS: C: Unaffected 

Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 

V: Set if arithmetic overflow occurs, that is, the 

sign of the destination was opposite the sign of the 

result; cleared otherwise 

Unaffected 

Unaffected 


mo 


CYCLES: dst  Word/Byte 
NS SS SL 

R 4 -- -- 

IR ll -- 

DA gee get 

X po eae gas 


NOTE: The "src field" in the instruction format encoding contains 
the source operand. The "src field" values range from 0 to 
15 corresponding to the source values 1 to 16. 
EXAMPLE: If register RH2 contains $21, the statement 
INCB RH2,#6 


will leave the value %27 in RH2. 
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IND 


Input and Decrement 


IND dst.sirc,;t dst: IR 
INDB sree ER 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 
FLAGS: C: 
Se 
Vis 
D: 
Ae 
CYCLES: 
NOTE: 
EXAMPLE: 
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dst <=.sre 
AUTODECREMENT dst {-l if byte, -2 if word} 
ro <r, = i 


This instruction is used for block input of strings of 
data. The contents of the I/O location addressed by the 
source register are loaded into the memory location 
addressed by the destination register. I/O addresses 

are always 16 bits. The destination register is then 
decremented by one if INDB, or by two if IND, thus 
moving the pointer to the previous element in the string. 
The word register specified by "r" (used as a counter) 

is then decremented by one. 


Unaffected 
Undefined 
Unaffected 
Set if the result of decrementing r is zero; cleared 
otherwise 
Unaffected 
Unaffected 


Word/Byte 
21 


This is a privileged instruction. 


In segmented mode, if register RR4 contains %02004000 
(segment 2, offset %4000), register R6 contains the I/O 
address %0228, the "port" %0228 contains %05B9, and 
register RO contains %0016, the statement 


IND @RR4,@R6,R0 
will leave the value %05B9 in location %02004000, the 


value %02003FFE in RR4, and the value $0015 in RO. 
Register R6 still contains the value %0228. 


INDR 


Input, Decrement and Repeat 


INDR dst,src,r dsit:, IR 
INDRB Ssre:22R: 


INSTRUCTION FORMAT: (F6.4) 


Q 


st src 


|g 
weer hi, pe) i IR R 


OPERATION: dst <= sric 
AUTODECREMENT dst {-l if byte, -2 if word} 
r<=rfrea 8 
repeat until r = 0 


This instruction is used for block input of strings of 
data. The contents of the I/O location addressed by 
the source register are loaded into the memory location 
addressed by the destination register. I/O addresses 
are always 16 bits. The destination register is then 
decremented by one if INDRB, or by two if INDR, 
thus moving the pointer to the previous element 
in the string. The word register specified by "r 
(used as a counter) is then decremented by one. The 
entire operation is repeated until the result of 
decrementing r is zero. This instruction can input 
from 1 to 65536 bytes or 32768 words (the value for r 
Must not be greater than 32768 for INDR). 


FLAGS: C: Unaffected 
Z: Undefined 
S: Unaffected 
Ve Set 
D: Unaffected 
H: Unaffected 


CYCLES: Word/Byte 
11+10*n (n=number of data elements transferred) 


NOTES: This is a privileged instruction. 


This instruction can be interrupted after each execution 
of the basic operation. The program counter value of 

the start of this instruction is saved before the in- 
terrupt request is accepted, so that the instruction can 
be properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 
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INDR 


Input, Decrement and Repeat 


EXAMPLE: If register Rl contains %202A, register R2 contains the 
I/O address %0050, and register R3 contains 8, the 
statement 


INDRB @R1,@R2,R3 


will input 8 bytes from "port" %0050 and leave them in 
descending order from %202A to %2023. Register R1 will 
contain %2022, and R3 will contain 0. R2 will not be 
affected. 
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INI 


Input and Increment 


INSTRUCTION FORMAT: 


7 CE 


INI dst ,.SEe pr dst: IR 
INIB sres ER 
(F6.4) 
dst sre 2x 
sre 0 0 0 0 E IR R 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


dst <= sre 
AUTOINCREMENT dst {+l if byte, +2 if word} 
Yr <= Pp = 


This instruction is used for block input of strings of 
data. The contents of the I/O location addressed by 
the source register are loaded into the memory location 
addressed by the destination register. I/O addresses 
are always 16 bits. The destination register is then 
incremented by one if INIB, or by two if INI, thus 
moving the pointer to the next element in the string. 
The word register specified by "r" (used as a counter) 
is then decremented by one. 


Unaffected 
Undefined 
Unaffected 
Set if the 
otherwise 
Unaffected 
Unaffected 


result of decrementing r is zero; cleared 


Word/Byte 
2M 


This is a privileged instruction. 


If register R4 contains %4000, register Ro contains the 
I/O address %0228, the "port" %0228 contains %B9, and 
register RO contains $0016, the statement 

INIB @R4,@R6,R0 


will leave the value %B9 in location %4000, the value 
$4001 in R4, and the value $0015 in RO. Register R6 
still contains the value %0228. 
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INIR 


Input, Increment and Repeat 


INIR dst,src,r dsts ik 
INIRB sree IR 
INSTRUCTION FORMAT: (F6.4) 
dst-.-SEGeer 
IR Ta R 


OPERATION: 


FLAGS: 


CYCLES: 


NOTES: 
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dsit <= sre 

AUTOINCREMENT dst {+l if byte, +2 if word} 
Baca eee o1. 

repeat until r = 0 


This instruction is used for block input of strings of 
data. The contents of the I/O location addressed by 
the source register are loaded into the memory location 
addressed by the destination register. I/O addresses 
are always 16 bits. The destination register is then 
incremented by one if INIRB, or by two if INIR, thus 
moving the pointer to the next element in the string. 
The word register specified by "r" (used as a counter) 
is then decremented by one. The entire operation 

is repeated until the result of decrementing r is 

zero. This instruction can input from 1 to 65536 bytes 
or 32768 words (the value for r must not be greater 
than 32768 for INIR). 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Word/Byte 


11+10*n (n=number of data elements transferred) 
This is a privileged instruction. 


This instruction can be interrupted after each execution 
of the basic operation. The program counter value of 
the start of this instruction is saved before the in- 
terrupt request is accepted, so that the instruction can 
be properly resumed. Seven more cycles should be added 
to this instruction's execution time for each interrupt 
request that is accepted. 


INIR 


Input, Increment and Repeat 


EXAMPLE: 


If register R1 contains %2023, register R2 contains 
the I/O address %0050, and register R3 contains 8, the 
statement 


INIRB @R1,@R2,R3 
will input 8 bytes from "port" %0050 and leave them in 
ascending order from %2023 to 202A. Register R1 will 


contain %$202B, and R3 will contain 0. R2 will not be 
affected. 
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IRET 


Interrupt Return 


IRET 


INSTRUCTION FORMAT: (E9)53)) 


OPERATION: Nonsegmented Segmented 
SP <- SP + 2 SP <- SP + 2 {Pop "identifier"} 
BS <= GSP PSe<=seSP 


SP <="SP +: 4 SPU<SSP +6 


This instruction is used to return to a previously 
executing procedure at the end of a procedure entered 

by an interrupt or trap (including a System Call 
instruction). First, the "identifier" word associated 
with the interrupt or trap is popped from the system 
processor stack and discarded. Then contents of the 
the location addressed by the system processor stack 
pointer are popped into the program status (PS), loading 
the Flags and Control Word (FCW) and the program 

counter (PC). The new value of the FCW is not effective 
until the next instruction, so that the status pins will 
not be affected by the new control bits until after the 
IRET instruction execution is completed. The next in- 
struction executed is that addressed by the new contents 
of the PC. The system stack pointer (R15 if nonsegmented, 
Or RR14 if segmented) is used. 


: Loaded from processor stack 
: Loaded from processor stack 
: Loaded from processor stack 
: Loaded from processor stack 
: Loaded from processor stack 
: Loaded from processor stack 


CYCLES: Address 
NS SS SL 
13) == 16 
NOTES: This is a privileged instruction. 


The 28001 version always executes the segmented mode 
of the IRET instruction. 
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EXAMPLE: 


IRET 


Interrupt Return 


In the nonsegmented Z8002 version, if the program 

counter contains %2550, the system stack pointer (R15) 
contains %3000, and locations %3000, %3002 and %3004 
contain %7F03, a saved FCW value, and %1004, respectively, 
the statement 


IRET 
will leave the value %3006 in the system stack pointer 
and the program counter will contain %1004, the address 


of the next instruction to be executed. The program 
status is now determined by the saved FCW value. 
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JP 


Jump 


JP ec,dst dst: IR, DA, X 


INSTRUCTION FORMAT: (F1.3) 


mode dst 


Perle, e,)] oO IR 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 
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Ol DA (dst field=0) 
01 X (dst field<>0) 


if cc is: true then PC <-— dst 


A conditional jump transfers program control to the 
destination address if the condition specified by "cc 
is true. See section 3.2.1 for a list of Condition codes. 
If the condition code is true, the program counter (PC) 

is loaded with the designated address; otherwise, 

control falls through to the instruction following the 

JP instruction. 


No flags affected 


(jump is taken) (jump not taken) 
dst Address Address 
NS SS SL NS’ SS “SL 
IR 10 -- 15 7 -= i 
DA 7 8 10 7 8 lo 
xX 8 8 AL 8 Saal 


The destination address must be even since instructions 
are word data. 


If the carry flag is set, the statement 
JP .¢, #1520 


replaces the contents of the program counter with 
$1520, thus transferring control to that location. 


JR 


Jump Relative 


JR ec, ast dst: RA 


INSTRUCTION FORMAT: (F3.3) 


Hee eT “A 20! [tes displacement RA 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLES: 


if ©¢ is true then PC <= PC + (2%disp) 


A conditional jump transfers program control to the 
destination address if the condition specified by "cc 
is true. See section 3.2.1 for a list of condition 
codes. If the condition code is true, the program 
counter (PC) is loaded with the designated address; 
otherwise, control falls through to the instruction 
following the JR instruction. 


No flags affected 


Address 
6 (jump is taken) 
6 (jump not taken) 


The relative addressing mode is calculated by doubling 
the displacement in the instruction, then adding this 
value to the updated value of the PC to derive the 
destination address. The updated PC value is taken to 
be the address of the instruction byte following the JR 
instruction, while the displacement is a 8-bit signed 
value in the range -128 to +127. Thus, the destination 
address must be in the range -254 to +256 bytes from the 
Start of the JR instruction. In the segmented mode, the 
PC segment number is not affected. The assembler auto- 
matically calculates the displacement by subtracting the 
PC value of the following instruction from the address 
given by the programmer. 


If the result of the last arithmetic operation executed 
is negative, the following four statements (which occupy 
a total of twelve bytes) are to be skipped. This can be 
accomplished with the statement 

JR MI,$+14 


If the S flag is not set, execution continues with the 
statement following the JR. 
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JR 


Jump Relative 


A byte-saving form of a jump to the label LAB is 
JR LAB 
where LAB must be within the allowed range. The condition 


code is "blank" in this case, and indicates that the 
jump is always taken. 
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INSTRUCTION FORMAT: (E2514) 


displacement 


(F4.3) 


we: Pelee re | 


R, 
R, 


LD 


Load 


IR, DA, X, BA, BX 
IM, 


IR, DA, X; BA, BX 


Src 


IM* (src field=0) 
IR (sre field<>0) 
DA (sre field=0) 
X (sre field<>0) 


src 
IM* 


*See Note 


Qu 
(a 
ct 


BA (sre field<>0) 


BX (sre field<>0) 


sre 

a 
R (dst field=0) 
R (dst field<>0) 


src 

IM 

IM (dst field=0) 
IM (dst field<>0) 
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Load 
(F4.2) 
dst src 
WAR tt ea eee a ee Pi BA R (dst field<>0) 
displacement 
Tse AL Die a ea et dst src 
= eee: tt 
displacement 
(F4.1) 
dst src 


W/B: BX R (dst field<>0) 


CG 
A ae a cc 
OPERATION: dst <= sre 


The contents of the source operand are loaded into the 
destination. The contents of the source are not affected. 


FLAGS: No flags affected 
CYCLES: dst src  Word/Byte Long 
NS SS _ SL Ns. SS, SL 

R R Se eet 13) een a 
R IM 4) tS Me f=. => 
R IM 5 (byte. only - see Note) 
R IR Thee I]. = 
R DA Se 50 12 2S lS 
R X iO}, ALO, Fas he) ts Lo 
R BA 14 == == 1 rng 
Be) A Oa ea ee te a 
IR R O35 Se Il <=<¢ 35 


DA R I a2. LA La 15° 07 


BA R 1 Sip oan 
BX R PAE I Te ie ee 
NOTE: Although both formats F2.1 and F3.2 exist -for 


"LDB R,IM", the assembler always uses the short 
format, B32. .In this case, the “sre field" 

in the instruction format encoding contains the 
source operand. 
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LD 


Load 


EXAMPLES: 


LD 


LD 


LD 


LD 


LDB 


LD 


LDL 


LD 


RO,R1 


RO, #20 


RO,20 


RO,@R1 


@R1,RHO 


R4,8(R1) 


RR4,R1 (#8) 


R1(R2) ,R4 


RO is loaded with the 
of register R11! 


!Register 
contents 
!Register RO is loaded with the value 
20! 


RO is loaded with the con- 
the word at location 20! 


!Register 
tents of 


!If register Rl contains 20, then 
register RO is loaded with the con- 
tents of the word at location 20! 


!I£f register Rl contains 20, then the 
byte at location 20 is loaded with 
the contents of register RHO! 


!If register Rl contains 20, then 
register R4 is loaded with the con- 
tents of the word at location 28 
(addressed by the sum of the address 8 
and the contents of the index register 
R1)! 


!If register Rl contains 20, then 
register RR4 is loaded with the con- 
tents of the long word at location 28 
(addressed by the sum of the base 
address contained in register Rl and 
the displacement 8) ! 


!If register Rl contains 20 and regis- 
ter R2 contains 8, then the word at 
location 28 (addressed by the sum of 
the base address contained in Rl and 
the contents of the index register R2) 
is loaded with the contents of register 
R4! 
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LDA 


Load Address 


LDA dst,src dst: R 
src: DA, xX, BA, Bs 


INSTRUCTION FORMAT: (E253) 
mode st src 


01 R DA (src field=0) 
Ce a ee ee ee ee 
Tere ee 


X (sre field<>0) 
(F4.4) 


src 
BA (src field<>0) 


OF 40) SHR 1: OF 01 Ceo src 


displacement 


dst sre 
R BX (src field<>0) 


OPERATION: dst <- ADDRESS src 


The address of the source operand is computed and loaded 
into the destination. The contents of the source are 

not affected. The address computation follows the rules 
for addressing mode arithmetic. The destination is a 

word register in nonsegmented mode, and a register pair 

in segmented mode (the segmented address loaded into the 
destination has an undefined value in all "reserved" bits). 


FLAGS: No flags affected 
CYCLES: src Address 
NS SS SL 
DA P2s SL SMAPS 
xX TS S735 116 
BA P5° -=5t== 
BX 15ai3=-=0 == 
EXAMPLES: LDA R4,STRUCT !In nonsegmented mode, register R4 is 
loaded with the nonsegmented address 
of the location named STRUCT! 
LDA RR2,8(R4) !In segmented mode, if index register 
R4 contains $0020, then register RR2 
is loaded with the segmented address 
00000028 (segment 0, offset 30028)! 
LDA RR2,RR4(#8) !In segmented mode, if base register 


RR4 contains %01000020, then reg- 
ister RR2 is loaded with the seg- 
mented address %01000028 (segment 1, 
offset %0028)! 
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LDAR 


Load Address Relative 
LDAR dst,src dst se 
src: RA 
INSTRUCTION FORMAT: (F4.4) 
dst sre 
melee] a, | RRA 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


Oo.0. 97.4.0. 4. O70) oO FoeNOy 0 
displacement 


dst <- ADDRESS src 


The address of the source operand is computed and loaded 
into the destination. The contents of the source are 
not affected. The destination is a word register in 
nonsegmented mode, and a register pair in segmented 

mode (the segmented address loaded into the destination 
has all "reserved" bits cleared to zero). 


No flags affected 


Address 
D5 


The relative addressing mode is calculated by adding the 
displacement in the instruction to the updated value 

of the program counter (PC) to derive the address. The 
updated PC value is taken to be the address of the in- 
struction byte following the LDAR instruction, while the 
displacement is a 16-bit signed value in the range -32768 
to +32767. The assembler automatically calculates the 
displacement by subtracting the PC value of the following 
instruction from the address given by the programmer. 


LDAR R2,DATA !Register R2 is loaded with the 


nonsegmented address of the 
location named DATA! 
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LDCTL 


Load Control Register 


LDCTL dst,src dst2, -R 7. GILR 
LDCTLB src: RR, CLriR 


INSTRUCTION FORMAT: (F8.1) 


OPERATION: LDCTLB FLAGS,R 
FLAGS (2:7) <- src(2:7) 


The contents of the source (a byte register) are 
loaded into the FLAGS register. The lower two bits 
of the FLAGS register and the entire source 
register are unaffected. 


LDCTLB _R,FLAGS 
dst(2:7) <- FLAGS (2:7) 
dsecosd) <= 0 


The contents of the upper six bits of the FLAGS 
register are loaded into the destination (a byte 
register). The lower two bits of the destination 
register are cleared to zero. The FLAGS register 
is unaffected. 


FLAGS: LDCTLB FLAGS,R Shaded areas are reserved 
Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 


tg 
CS 
mO<anNNOa 


LDCTLB R,FLAGS 
No flags affected 
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CYCLES: 


NOTE: 


EXAMPLE: 


LDCTL 


Load Control Register 


7 


This is the only Load Control Register 
instruction which is not privileged, thus it can be 
used in Normal or System mode. 
If the C, S and H flags are set (=1), 
all other flags are clear (=0), the 
statement 
LDCTLB RHO,FLAGS 


will leave the value $A4 (10100100) in RHO. 
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LDCTL 


Load Control Register 


INSTRUCTION FORMAT: (F8.1) 


W: 


CRI 
s 
wee), [ee] OR TER 


OPERATION: LDCTL FCW,R 
FCW(2:7) <- src(2:7) 
FCW(11:15) <- sre(l1:15) 


The contents of the source (a word register) are 
loaded into the Flags and Control Word (FCW) 
register. Bits 0, 1, 8, 9 and 10 of the FCW 
register and the entire source register are 
unaffected. 


LDCTL R,FCW 

ase (27) <= ECWi(227) 
dse(11s15) <= Few (11:15) 
dst(0'2 1) <= <0 

dst(3'3:1'0) <= 0 


The contents of the FCW register are loaded into 
the destination (a word register). Bits 0, l, 8, 9 
and 10 of the destination register are cleared to 
zero. The FCW register is unaffected 


15) 44: 1S! 12) 0-49) 90. 28 8 <r ee ee} 


* Timi 


FLAGS: LDCTL FCW,R Shaded areas are reserved 


: Loaded from source 

Z: Loaded from source 
S: Loaded from source 
P/V: Loaded from source 
D: Loaded from source 
H: Loaded from source 


LDCTL R,FCW 
No flags affected 
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LDCTL 


Load Control Register 


CYCLES: i) 
NOTE: This is a privileged instruction. 
EXAMPLE: If register R7 contains %D8FC 


(1101100011111100), the statement 
LDCTL FCW,R7 
will leave the value %D8FC in the FCW register 


(Segmentation and System modes are set, interrupts 
are enabled, and all the flags are set). 
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LDCTL 


Load Control Register 


INSTRUCTION FORMAT: (#85) 
dst src 
1 COCORICRREDY Fn  SUNOECE 
(F8.2) 
dst src 
wee, te] oR OPER 
OPERATION: LDCTL REFRESH,R 
REFRESH(1:15) <- srce(1:15) 
The contents of the source (a word register) are 
loaded into the REFRESH register. Bit 0 of the 
REFRESH register and the entire source register are 
unaffected. 
LDCTL R,REFRESH 
dst(1:8) <- REFRESH(1:8) 
dst(0) <- 0 
dst(9:15) <- undefined 
The contents of the counter field (bits 1 to 8) of 
the REFRESH register are loaded into the 
destination (a word register). Bit 0 of the 
destination register is cleared to zero, and the 
upper seven bits are undefined. The REFRESH 
register is unaffected. 
1S a Fey AZ) oto: SF 18: 7 6 5 4 3 2 1 0 
rerresu:[*] , 4, , [ , , corey | 
We [pee Neg PO a eee aed 
Shaded a served 
FLAGS: No flags affected oP ic alae : 
CYCLES: 7 
NOTE: This is a privileged instruction. 
EXAMPLE: If register RO contains the value %8600 
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(1000011000000000), the statement 


LDCTL REFRESH ,RO 
will leave the value %8600 in the REFRESH register 


(refresh is enabled, the rate is 3, and the counter 
starts at zero). 


LDCTL 


Load Control Register 


INSTRUCTION FORMAT: (F8.1) 


woot, Te] | CTR 


(F8.2) 


Welo 4.4. 9%. 1.41.0 ee ae Oxi _or 0 R CTLR 


OPERATION: LDCTL PSAPSEG,R 
PSAPSEG(8:14) <- src(8:14) 


The contents of the source (a word register) are 
loaded into the Program Status Area Pointer Segment 
(PSAPSEG) register. Bits 0, l, Océwepl, and US of 
the PSAPSEG register and the entire source register 
are unaffected. 


LDCTL R,PSAPSEG 
dst(8:14) <- PSAPSEG(8:14) 
ast(0s7) <—-0 

dst(15) <= 0 


The contents of the PSAPSEG register are loaded 
into the destination (a word register). Bits 0, ly 
2 «easel poand 25 o£ the destination register are 
cleared to zero. The PSAPSEG register is 
unaffected. 


AB. 44046) 42 TH. 400 1. Be Gi AS Ue 
SEGMENT NUMBER 


Shaded areas are reserved 


PSAPSEG: 


FLAGS: No flags affected 
CYCLES: 7 
NOTES: This is a privileged instruction. 


The PSAPSEG register may not be used in the 
nonsegmented 28002 version. In the segmented 28001 
version, care must be exercised when changing the 
two PSAP register values so that an interrupt 
occurring between the changing of PSAPSEG and 
PSAPOFF is handled correctly. 
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LDCTL 


Load Control Register 


EXAMPLE: If register R12 contains %0200, the statement 


LDCTL PSAPSEG,R12 


will leave the value %0200 (segment 2) in 
the PSAPSEG register. 
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INSTRUCTION FORMAT: 


ele 9 toa 7, 1 Se ae a 


OPERATION: 


FLAGS: 


CYCLES: 


NOTES: 


LDCTL 


Load Control Register 


(F8.1) 


(F8.2) 


hoe Te] OR CCTER 


LDCTL PSAPOFF,R 
PSAPOFF(8:15) <- srce(8:15) 


The contents of the source (a word register) are 
loaded into the Program Status Area Pointer Offset 
(PSAPOFF) register. Bits 0, 1, 2,...,7 of the 
PSAPOFF register and the entire source register are 
unaffected. 


LDCTL R,PSAPOFF 
dst(8:15) <- PSAPOFF(8:15) 
dst(027), <= 0 


The contents of the PSAPOFF register are loaded 
into the destination (a word register). Bits 0, l, 
2,.--,7 Of the destination register are cleared to 
zero. The PSAPOFF register is unaffected. 


18° 49) 105 A211 10 8) 8 oF. 8. AS Ue 8 


UPPER OFFSET 


Shaded areas are reserved 


PSAPOFF: 


No flags affected 
7 
This is a privileged instruction. 


In the nonsegmented 28002 version, the mnemonic 
"PSAP" should be used in the assembly language 
statement, and indicates the same control register 
as the mnemonic "PSAPOFF". 


In the segmented 28001 version, care must be 
exercised when changing the two PSAP register 
values so that an interrupt occurring between the 
changing of PSAPSEG and PSAPOFF is handled 
correctly. 
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LDCTL 


Load Control Register 


EXAMPLE: If the PSAPOFF register contains %0100, 
the statement 
LDCTL R13,PSAPOFF 


will leave the value %0100 in register R13. 
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LDCTL 


Load Control Register 


INSTRUCTION FORMAT: (F8.1) 


oer 


OPERATION: 


FLAGS: 


CYCLES: 


NOTES: 


EXAMPLE: 


LDCTL NSPSEG,R 
NSPSEG <- src 


The contents of the source (a word register) are 
loaded into the Normal Stack Pointer Segment 
(NSPSEG) register. In segmented mode, the NSPSEG 
register is R14 in Normal mode, and contains the 
segment number of the normal processor stack 
pointer. (In nonsegmented mode, R14 is not used as 
part of the normal processor stack pointer.) 


LDCTL R,NSPSEG 
dst <-— NSPSEG 


The contents of the NSPSEG register are loaded into 
the destination (a word register). The NSPSEG 
register is unaffected. 

15. 44 13: 42 4 10.9 8. 7 6 6 4 3 2 1 0 


NSPSEG: 


No flags affected 


R: 


4 
This is a privileged instruction. 


The NSPSEG register may not be used in the 
nonsegmented 28002 version. 


If register R12 contains %7F00, the statement 
LDCTL NSPSEG,R12 


will leave the value @7F00 (segment %7F) 
in the NSPSEG register. 
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LDCTL 


Load Control Register 


INSTRUCTION FORMAT: (F8.1) 


OPERATION: 


FLAGS: 
CYCLES: 


NOTES: 


EXAMPLE: 
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LDCTL NSPOFF,R 
NSPOFF <- src 


The contents of the source (a word register) are 
loaded into the Normal Stack Pointer Offset 
(NSPOFF) register. In segmented mode, the NSPOFF 
register is R15 in Normal mode, and contains the 
offset part of the normal processor stack pointer. 
In nonsegmented mode, R15 is the entire normal 
processor stack pointer. The source register is 
unaffected. 


LDCTL R,NSPOFF 
dst <- NSPOFF 


The contents of the NSPOFF register are loaded into 
the destination (a word register). The NSPOFF 
register is unaffected. 


1S das eh Oe On aa oe rors At 0 


NSPOFF: 


No flags affected 

4 

This is a privileged instruction. 

In the nonsegmented 28002 version, the mnemonic 
"NSP" should be used in the assembly language 
statement, and indicates the same control register 
as the mnemonic "NSPOFF". 


If the NSPOFF register contains %F002, 
the statement 


LDCTL R13,NSPOFF 


will leave the value %F002 in register R13. 


LDD 


Load and Decrement 


LDD dst,src,r ast: LR: 

LDDB sre: DR 
INSTRUCTION FORMAT: (F6.4) 

dst. ‘sric 


OPERATION: 


FLAGS: C: 
ais 
S: 
Vs 
Ds 
Bie 

CYCLES: 

EXAMPLE: 


dst <- src 
AUTODECREMENT dst and sre {-l if byte, -2 if word} 
r <= r= 1 


This instruction is used for block transfers of strings 
of data. The contents of the location addressed by the 
source register are loaded into the location addressed 

by the destination register. The source and destination 
registers are then decremented by one if LDDB, or by two 
if LDD, thus moving the pointers to the previous elements 
in the strings. The word register specified by "r" (used 
as a counter) is then decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
20 


If register Rl contains %202A, register R2 contains 
404A, the word at location %$404A contains %FFFF, and 
register R3 contains 5, the statement 


LDD @R1,@R2,R3 
will leave the value $FFFF in location %202A, the value 


$2028 in Rl, the value $4048 in R2, and the value 4 in 
R3. 
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LDDR 


Load, Decrement and Repeat 


LDDR dst,src,r dst: IR 
LDDRB src: IR 
INSTRUCTION FORMAT: (F6.4) 


r 
ween he, [ae] I IRR 


OPERATION: 


FLAGS: 


CYCLES: 
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mo<annogn 


oe ee 08 oe 82 ee 


dst <— isrc 

AUTODECREMENT dst and src {-1 if byte, -2 if word} 
r= Sk 

repeat until r = 0 


This instruction is used for block transfers of strings 
of data. The contents of the location addressed by the 
source register are loaded into the location addressed 

by the destination register. The source and destination 
registers are then decremented by one if LDDRB, or by two 
if LDDR, thus moving the pointers to the previous elements 
in the strings. The word register specified by "r" (used 
as a counter) is then decremented by one. The entire 
operation is repeated until the result of decrementing 

r is zero. This instruction can transfer from 1 to 

65536 bytes or 32768 words (the value for r must. not 

be greater than 32768 for LDDR). 


The effect of decrementing the pointers during the 
transfer is important if the source and destination 
strings overlap with the source string starting at a 
lower memory address. Placing the pointers at the 
highest address of the strings, and decrementing the 
pointers, ensures that the source string will be copied 
without destroying the overlapping area. 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Word/Byte 
114+9*n (n=number of data elements transferred) 


LDDR 


Load, Decrement and Repeat 


NOTE: 


EXAMPLE: 


This instruction can be interrupted after each execution 
of the basic operation. The program counter value of the 
start of this instruction is saved before the interrupt 
request is accepted, so that the instruction can be 
properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 


If register Rl contains %202A, register R2 contains 
404A, the words at locations %4040 through %404A all 
contain $FFFF, and register R3 contains 5, the statement 


LDDR @R1,@R2,R3 
will leave the value $FFFF in the words at locations 


$2020 through %202A, the value %201E in Rl, the value 
$403E in R2, and O in R3. 
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LDI 


Load and Increment 


LDI dS SKC; .% dst: IR 
LDIB Seca wR 


INSTRUCTION FORMAT: (F6.4) 


dso csre- 7 
W/B: ER cles, SR 
OPERATION: adst_<=:sre 
AUTOINCREMENT dst and src {+l if byte, +2 if word} 
B-<])r c= 1 
This instruction is used for block transfers of strings 
of data. The contents of the location addressed by the 
source register are loaded into the location addressed 
by the destination register. The source and destination 
registers are then incremented by one if LDIB, or by two 
if LDI, thus moving the pointers to the next elements 
in the strings. The word register specified by "r" (used 
as a counter) is then decremented by one. 
FLAGS: C: Unaffected 
Z: Undefined 
S: Unaffected 
Vv: Set if the result of decrementing r is zero; cleared 
otherwise 
D: Unaffected 
H: Unaffected 


CYCLES: Word/Byte 


EXAMPLE: This instruction is used in a "loop" of instructions 
which transfers a string of data from one location to 
another, but an intermediate operation on each data 
element is required. The following sequence transfers a 
string of 80 bytes, but tests for a special value (%0D, 
an ASCII return character) which terminates the loop if 


found: 
LD R3,#80 !Initialize counter! 
LD R1,#DSTBUF !Load start addresses! 
LD R2,#SRCBUF 
LOOP: 
CPB @R2,#%0D !Check for return character! 
JR EQ,DONE !Exit loop if found! 
LDIB @R1,@R2,R3 !Transfer next byte! 
JR NOV, LOOP !Repeat until counter=0! 
DONE: 
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LDIR 


Load, Increment and Repeat 


EDIR  dstsSre nr dst: IR 


LDIRB sre: IR 
INSTRUCTION FORMAT: (F6.4) 
dst sre 
IR IR R 


OPERATION: dst <-. sre 
AUTOINCREMENT dst and src {+l if byte, +2 if word} 
r<-r-l 
repeat until r = 0 


This instruction is used for block transfers of strings 
of data. The contents of the location addressed by the 
source register are loaded into the location addressed 

by the destination register. The source and destination 
registers are then incremented by one if LDIRB, or by two 
if LDIR, thus moving the pointers to the next elements 

in the strings. The word register specified by "r" (used 
as a counter) is then decremented by one. The entire 
operation is repeated until the result of decrementing 

r is zero. This instruction can transfer from 1 to 

65536 bytes or 32768 words (the value for r must not 

be greater than 32768 for LDIR). 


The effect of incrementing the pointers during the 
transfer is important if the source and destination 
strings overlap with the source string starting at a 
higher memory address. Placing the pointers at the 
lowest address of the strings, and incrementing the 
pointers, ensures that the source string will be copied 
without destroying the overlapping area. 
FLAGS: Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


TMo<anna 


CYCLES: Word/Byte 
11+9*n (n=number of data elements transferred) 
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LDIR 


Load, Increment and Repeat 


NOTE: 


EXAMPLE: 
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This instruction can be interrupted after each execution 
of the basic operation. The program counter value of the 
start of this instruction is saved before the interrupt 
request is accepted, so that the instruction can be 
properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 


The following sequence of instructions can be used to 
copy a buffer of 512 words (1024 bytes) from one area to 
another. The pointers to the start of the source and 
destination buffers are set, the number of words to 
transfer is set, and then the transfer is accomplished. 


LD Rl, #DSTBUF 
LD R2,#SRCBUF 
LD R3,#512 


LDIR @R1,@R2,R3 


LDK 


Load Constant 


LDK dst,srce dst: 
src: IM 


INSTRUCTION FORMAT: (F1.2) 


mode St,» SEC 


wheelie] ee, ] 10 oR 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


dst.<- sre {sre—is=0..to_15} 


The source operand (a constant value) is loaded into 
the destination. The source is a value from 0 to 
15 which is loaded into the low-order four bits of 
the destination with the high-order twelve bits 
cleared to zeros. 


No flags affected 


Word 
5 


The "src field" in the instruction format encoding 
contains the source operand. The "src field" values 
range from 0 to 15 corresponding to the source values 
0 to 15. 


LDK R3,#9 !Register R3 is loaded with the 
value 9! 
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LDM 


Load Multiple 
LDM dst,src,num ast. RL, DAY xX 
SreivR; ck, DA ox 
num: IM 


INSTRUCTION FORMAT: (F6.1) 


FLAGS: 


CYCLES: 


NOTES: 
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mode st isne 


00 R IR 
01 R DA (src field=0) 
Ol R X (src field<>0) 


mode dst src 


R 
R (dst field=0) 
R (dst field<>0) 


Registers from Memory 


Rdst,Rdst+num-1l <- src 


The contents of num source words are loaded into the 
destination register and the following (num-1) registers. 
The contents of the source(s) are not affected. The 
value of num can vary from 1 to 16, and the registers 

are loaded in increasing order, with RO following R15. 


Memory from Registers 


dst <- Rsrc,Rsrctnum-1l 


The contents of num word registers including the source 
register and the following (num-1) registers are loaded 
into the destination words. The contents of the source(s) 
are not affected. The value of num can vary from 1 to 16, 
and the registers are loaded in increasing order, with RO 
following R15. 


No flags affected 


dst src Word 
NS Ss SL 
R IR 11+3¥*n -- == (n=number of registers) 


R DA 14+3%n 15+3%n 174+3*n 

R »4 154+3*n 15+3%n 18+3*n 
R LIi+3*n =< == 

DA R 14+3*n 15+3*n 17+3¥*n 
R TIS+3*n 1U5+3*n° L8+3*n 


The "num field" in the instruction format encoding contains 
the num operand. The "num field" values range from 0 to 15 
corresponding to the num values 1 to 16. 


LDM 


Load Multiple 


The starting address of the block of memory where the reg- 
isters are loaded from or to is computed once at the start 
of execution, and incremented by two for each register 
loaded. If the original address computation involved a 
register, the register's value will not be affected by 
the address incrementation during execution. 

EXAMPLE: If register R5 contains 5, R6 contains %0100, and R7 
contains 7, the statement 


LDM @R6,R5,#3 


will leave the values 5, $0100, and 7 at word locations 
30100, $0102, and %0104, respectively, and none of the 
registers will be affected. 
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LDPS 


Load Program Status 


LDPS src Seis, ER, DA ok 


INSTRUCTION FORMAT: (F2.3) 


mode src 


|mode} 11 4 0 0 1] see [o 0 0 0 00 IR 


OPERATION: 
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O01 DA (src field=0) 
01 X (sre field<>0) 


PS .<= sre 


The contents of the source operand are loaded into 
the Program Status (PS), loading the Flags and 
Control Word (FCW) and the program counter (PC). 
The new value of the FCW does not become effective 
until the next instruction, so that the status pins 
will not be affected by the new control bits until 
after the LDPS instruction execution is completed. 
The next instruction executed is that addressed by 
the new contents of the PC. The contents of the 
source are not affected. 


This instruction is used to set the Program Status 
of a program, and is particularly useful for 
setting the System/Normal mode of a program to 
Normal mode, or for running a nonsegmented program 
in the segmented 28001 version. The PC segment 
number is not affected by the LDPS instruction in 
nonsegmented mode. 


The format of the source operand (Program Status 
block) depends on the current Segmentation mode 
(not on the version of the 28000), and is 
illustrated in the following figure: 


NONSEGMENTED LOW ADDRESS SEGMENTED 


FCW 


HIGH ADDRESS 


(shaded area is reserved--must be zero) 


LDPS 


Load Program Status 


FLAGS: C: 


CYCLES: 


NOTE: 


EXAMPLE: 


Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 
Loaded from source 


src Address 
NS SS SL 

IR 12 = 16 
DA 16 20 22 
X V7 20°.23 


This is a privileged instruction. 


In the nonsegmented 28002 version, if the 

program counter contains %2550, register R3 
contains 35000, location %5000 contains %1800, and 
location %5002 contains %A000, the statement 


LDPS @R3 
will leave the value A000 in the program counter, 


and the FCW value will be %1800 (indicating Normal 
mode, interrupts enabled, and all flags cleared). 


I71 


LDR 


Load Relative 


LDR dst,src dst: R, RA 
LDRB Se 2niR,) RA 
LDRL 


INSTRUCTION FORMAT: (F4.4) 


weenie eee] a, ] OR RR 


dst sre 


displacement 


(F4.2) 
dst sre 
W/B:[9,°,1,1,9,0,1]wefo oo of se | RA “R- 


displacement 


displacement 


OPERATION: 


FLAGS: 


CYCLES: 


NOTES: 


EXAMPLE: 
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dst <- sre 


The contents of the source operand are loaded into the 
destination. The contents of the source are not affected. 


No flags affected 


Word/Byte Lon 
14 i 


The relative addressing mode is calculated by adding the 
displacement in the instruction to the updated value of 
the program counter (PC) to derive the operand's address. 
The updated PC value is taken to be the address of the 
instruction byte following the LDR, LDRB, or LDRL 
instruction, while the displacement is a 16-bit signed 
value in the range -32768 to +32767. The assembler auto- 
matically calculates the displacement by subtracting the 
PC value of the following instruction from the address 
given by the programmer. 


Status pin information during the access to memory 
for the data operand will be IFn instead of MREQ 
because the address is relative to PC. 


LDR R2,DATA !Register R2 is loaded with the 
value in the location named DATA! 


MBIT 


Multi-Micro Bit Test 


MBIT 


INSTRUCTION FORMAT: (F9.3) 


OPERATION: S <- NOT ul 


This instruction is used to synchronize multiple 
processors' exclusive access to shared hardware 
resources. The multi-micro input pin (pi) is 
tested, and the S flag is cleared if the pin is one 
(active state = low voltage); otherwise, the S flag 
is set, indicating that the pin is zero (inactive 
state = high voltage). 


After the MBIT instruction is executed, the S flag 
can be used to determine whether a requested 
resource is available or not. If the S flag is 
clear, then the resource is not available; if the S 
flag is set, then the resource is available for use 
by this CPU. 

FLAGS: Unaffected 

Undefined 

Set if pI is zero; cleared otherwise 

Unaffected 

Unaffected 

Unaffected 


TO<InNNO 


CYCLES: 7 
NOTE: This is a privileged instruction. 
EXAMPLE: The following sequence of instructions can 


be used to wait for the availability of a 
resource. 


LOOP: 

MBIT !Test multi-micro input! 

JR PL,LOOP !Repeat until resource is available! 
AVAILABLE: 
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MREQ 


Multi-Micro Request 


MREQ dst dSit: “® 


INSTRUCTION FORMAT: (F8.2) 


whoa ee] OF 
OPERATION: Z<=- 0 


if pl = 1 then 5S <= 0 
po <- 0 


else pO <- 1 
repeat dst <- dst - l 
pntil dst = 0 
Lit ile=slpathen! &Si<-s4 
el’iseipsi<= 10 
O™<=: 0 
(Net fal 


This instruction is used to synchronize multiple 
processors' exclusive access to shared hardware 
resources. A request for a resource is signalled 
through the multi-micro input and output pins (pl 
and 0), with the S and Z flags indicating the 
availability of the resource after the MREQ 
instruction has been executed. 


First, the Z flag is cleared. Then the pI pin is 
tested. If the pI pin is one (active state = low 
voltage), the S flag is cleared and the 0 pin is 
cleared to zero (inactive state = high voltage), 
thus indicating that the resource is not available. 


Instruction execution is finished in this case. 


If the pI pin is zero, indicating that the resource 
may be available, a sequence of machine operations 
occurs. First, the pO pin is set to one (active 
state = low voltage), signalling a request by the 
CPU for the resource. Next, a finite delay to 
allow for propagation of the signal to other 
processors is accomplished by repeatedly 
decrementing the contents of the destination (a 
word register) until its value is zero. Then the 
pl pin is tested to determine whether the request 
for the resource was acknowledged. If the pl pin 
is one (active state = low voltage), the S flag is 
set to one indicating that the resource is_ 
available and access is granted. If the pI pin is 
zero (inactive state = high voltage), the S flag is 
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MREQ 


Multi-Micro Request 


cleared to zero, and the pO pin is cleared to zero 
(inactive state = high voltage), indicating that 
the request was not granted. Finally, in either 
case, the Z flag is set to one, indicating that the 
original test of the pI pin caused a request to be 
made. 


S flag 2Z flag pO Indicates 
0 


0 0 Request not signalled 


(resource not available) 


oO 
ra 
oO 


Request not granted 
(resource not available) 


L ai ul Request granted 

(resource available) 

FLAGS: Unaffected 

Set if request was signalled; cleared otherwise 

Set if request was signalled and granted; 

cleared otherwise 

Unaffected 

Unaffected 

Unaffected 


NNOA 


mod 


CYCLES: 12 (request not signalled) 
12+7*n (request signalled, n=number 
of times destination is decremented) 


NOTE: This is a privileged instruction. 


EXAMPLE: LRY'$ 
LD RO, #50 !Allow for propagation delay! 
MREQ RO !Multi-micro request with 
delay in register RO! 
JR MI , AVAILABLE 


JR Z,NOT GRANTED 
NOT AVAILABLE: . !Resource not available! 
NOT GRANTED: : !Request not granted! 

JR RY !Try again after awhile! 
AVAILABLE: - !Use resource! 

MRES !Release resource! 
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MRES 


Multi-Micro Reset 


MRES 


INSTRUCTION FORMAT: (F9.3) 


OPERATION: po <- 0 


This instruction is used to synchronize multiple 
processors' exclusive access to shared hardware 
resources. The multi-micro output pin (pO) is 
cleared to zero (inactive state = high voltage). 


Resetting 0 to zero is used to indicate that a 
resource controlled by the CPU is available for use 
by other processors. 


FLAGS: No flags affected 

CYCLES: 5 

NOTE: This is a privileged instruction. 
EXAMPLE: MRES !Signal that resource controlled 


by this CPU is available to 
other processors! 
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MSET 


Multi-Micro Set 


MSET 


INSTRUCTION FORMAT: (E9...3') 


OPERATION: 


FLAGS: 
CYCLES: 
NOTE: 


EXAMPLE: 


po <- 1 


This instruction is used to synchronize 

multiple processors' exclusive access to shared 
hardware resources. The multi-micro output pin 
(pO) is set to one (active state = low voltage). 


Setting uO to one is used either to indicate that a 
resource controlled by the CPU is not available to 
other processors, or to signal a request for a 
resource controlled by some other processor. 

No flags affected 

5 


This is a privileged instruction. 


MSET !Signal that controlled resource 
is not available to other processors! 
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MULT 


Multiply 


MULT dst,src dst: R 
MULTL src: R; IM, IR, DA, X 


INSTRUCTION FORMAT: (F221) 
mode dst src 


oF CED rs Ae 
Pe. oe ee a ee 
L: | mode | 0 Tote sO 7 i 00 R IR (sre field<>0) 
ae oe Ol R DA (src field=0) 
Ol R X (sre field<>0) 


OPERATION: Word 
dst,dstyl <- dstyl * ‘sre 


Long 
st,dstyl,dsty2,dsty3 <- dsty2,dsty3 * src,srcyl 


The low-order half of the destination operand (multi- 
plicand) is multiplied by the source operand (multiplier) 
and the product is stored in the destination. The con- 
tents of the source are not affected. Both operands are 
treated as signed, two's complement integers. For MULT, 
the destination is a register pair and the source is a 
word value; for MULTL, the destination is a register 
quadruple and the source is a long word value. 


FLAGS: C: MULT - set if product is less than -2" or greater than 
or equal to 2%; cleated otherwise; MULTL - set if pro- 
duct is less than 2" or greater than or equal to 2” ; 
cleared otherwise 


Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 
V: Cleared 

D: Unaffected 

H: Unaffected 
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CYCLES: 


NOTE: 


EXAMPLE: 


(Multiplier is zero) 


R 
IM 
IR 
DA 

Xx 


NS 
70 
70 
70 
72 
72 


18 
18 
18 
19 
20 


20 
20 


22 
22 


MULT 


Multiply 
Lon g 
NS ss SL 
282+7*n -- oe 
282+7*n -- -- 
282+7*n -- 


283+7*n 284+7*n 286+7*n 
2844+7*n 284+7*n 287+7*n 


(n=number of bits equal to 
one in the absolute value of 
the low-order 16 bits of 

the destination operand) 


30 -- _ 
30 -- ~~ 
30 -- -- 
31 32 34 
32 32 35 


For proper instruction execution, the "dst field" in 
the instruction format encoding must be even for’MULT, 
and must be a multiple of 4 (0, 4, 8, 12) for MULTL. 
If the source operand in MULTL is a register, the "src 


field" 


must be even. 


If register RQO (composed of register pairs RRO and 
RR2) contains %$2222222200000031 (RR2 contains decimal 


49), the statement 


MULTL RQO,#10 


will leave the value S00000000000001EA (decimal 490) 


in RQO. 


ged 


NEG 


Negate 
NEG dst dst: R, IR, DA, X 
NEGB 

INSTRUCTION FORMAT: (F1.1) 


mode dst 


W/Bs [mode] STH ES oe ae wey eS, opepeen] =“ EOs: ER 


OPERATION: 


FLAGS: C: 


CYCLES: 


EXAMPLE: 
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00 IR 
Ol DA (dst field=0) 
Ol X (dst field<>0) 


dst <- = dst 


The contents of the destination is negated, that is, 
replaced by its two's complement value. Note that 
$8000 for NEG and %80 for NEGB are replaced by them- 
selves since in two's complement representation the 
most negative number has no positive counterpart. 


Cleared if the result is zero; set otherwise, which 
indicates a "borrow" 

Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 
Set if the result is %8000 for NEG, or %80 for NEGB; 
cleared otherwise 


Unaffected 

Unaffected 
dst Word/Byte 
NSi = SSi; SL 
R 7 o<-- == 
IR 12 == =r 
DA 1 16 28 
xX 16 6 6, ~ 9 


If register R8 contains %051F, the statement 
NEG R8 


will leave the value %FAE1 in R8. 


NOP 


No Operation 


NOP 


INSTRUCTION FORMAT: (F9:.3) 


OPERATION: 
No operation is performed. This instruction may be 
used for timing delays. 

FLAGS: No flags affected 

CYCLES: 7 
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OR 


Or 


OR dst,src dst: R 
ORB sre: RR, IM, IR, DA, X 


INSTRUCTION FORMAT: (F2.1) 


dst 
wa:[meee oe tw ee, |, | 0 Rk OR 

R 

R 

R 

R 


OPERATION: 
FLAGS: C: 
as 
is 
P's 
Dr 
Hie 
CYCLES: 
EXAMPLE: 


182 


mode src 


00 
00 
O01 
O01 


IM (src field=0) 
IR (src field<>0) 
DA (src field=0) 
X (sre field<>0) 


dst <- dst OR src 


The source operand is logically ORed with the destination 
operand and the result is stored in the destination. The 
contents of the source are not affected. The OR operation 
results in a one bit being stored whenever either of the 
corresponding bits in the two operands is one; otherwise, 
a zero bit is stored. 


Unaffected 


“Set if the result is zero; cleared otherwise 


Set if the most significant bit of the result is set; 
cleared otherwise 

OR - unaffected; ORB - set if parity of the result is even; 
cleared otherwise 


Unaffected 

Unaffected 
sre Word/Byte 
NS SS SL 
R 4 -- -- 
IM 0 Se ‘es 
IR Jo-- -- 
DA 9 10°. 12 
xX WO; AOR RS: 


If register RL3 contains %$C3 (11000011) and the source 
operand is the immediate value %7B (01111011), the 
statement 

ORB RL3,#%7B 


will leave the value $FB (11111011) in RL3. 


OTDR 


Output, Decrement and Repeat 


OTDR’ ~ dst, src, r dst: IR 
OTDRB Srcz- IR 
INSTRUCTION FORMAT: (F6.4) 


OPERATION: 
FLAGS: Zi 
os 
V: 
Des 
Ei 
CYCLES: 
NOTES: 


os | 
w 
tH. 
wo 
mn 


dst <—"sire 

AUTODECREMENT src {-l if byte, -2 if word} 
r< £ = 1 

repeat until r = 0 


This instruction is used for block output of 
strings of data. The contents of the memory 
location addressed by the source register are 
loaded into the I/O location addressed by the 
destination register. I/0 addresses are always 16 
bits. The source register is then decremented by 
one if OTDRB, or by two if OTDR, thus moving the 
pointer to the previous element in the string. The 
word register specified by "r" (used as a counter) 
is then decremented by one. The entire operation 
is repeated until the result of decrementing r is 
zero. This instruction can output from 1 to 65536 
bytes or 32768 words (the value for r must not be 
greater than 32768 for OTDR). 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Word/Byte 
114+10#n (n=number of data elements transferred) 


This is a privileged instruction. 


This instruction can be interrupted after each 
execution of the basic operation. The program 
counter value of the start of this instruction is 
saved before the interrupt request is accepted, so 
that the instruction can be properly resumed. 
Seven more cycles should be added to this 
instruction's execution time for each interrupt 
request that is accepted. 
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OTDR 


Output, Decrement and Repeat 


EXAMPLE: If register R11 contains %0FFF, register 
R12 contains %B006, and R13 contains 6, the 
statement 


OTDR @R11,@R12,R13 


will output the string of words from locations 
SAFFC to %B006 in descending order to "port" %0FFF. 
R12 will contain %AFFA, and R13 will contain 0. 

R11 will not be affected. 


184 


OTIR 


Output, Increment and Repeat 


OTIR . dst,;srcec,r dst: IR 
OTIRB sresx TR 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 


FLAGS: Cs: 
Z: 
S: 
Ve 
Dis 
Hie 

CYCLES: 

NOTES: 


dst <= sre 

AUTOINCREMENT src {+l if byte, +2 if word} 
P< rel 

repeat until r = 0 


This instruction is used for block output of 


strings of data. The contents of the memory 
location addressed by the source register are 
loaded into the I/O location addressed by the 
destination register. I/O addresses are always 16 
bits. The source register is the incremented by 
one if OTIRB, or by two if OTIR, thus moving the 
pointer to the next element in the string. The 
word register specified by "r" (used as a counter) 
is then decremented by one. The entire operation 
is repeated until the result of decrementing r is 
zero. This instruction can output from 1 to 65536 
bytes or 32768 words (the value for r must not be 
greater than 32768 for OTIR). 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Word/Byte 
114+10*n (n=number of data elements transferred) 


This is a privileged instruction. 


This instruction can be interrupted after each 
execution of the basic operation. The program 
counter value of the start of this instruction is 
saved before the interrupt request is accepted, so 
that the instruction can be properly resumed. 
Seven more cycles should be added to this 
instruction's execution time for each interrupt 
request that is accepted. 
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OTIR 


Output, Increment and Repeat 


EXAMPLE: The following sequence of instructions can be 
used to output a string of bytes to the specified 
I/O "port". The pointers to the I/O port and the 
start of the source string are set, the number of 
bytes to output is set, and then the output is 
accomplished. 


LD R1,#PORT 
LD R2,#SRCBUF 
LD R3, #LENGTH 


OTIRB @R1,@R2,R3 


186 


OUT dst;sre dst: IR,DA 
OUTB sres R 


INSTRUCTION FORMAT: (F7.4) 


W/B:|0 0 1 


moore [,e,) om FR 


(F7.2) 


wee le] | RR 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


dst <- src 


The contents of the source operand are loaded into 
the destination. I/O addresses are always 16 bits. 


No flags affected 
st Word/Byte 
IR 
DA al 7J 
This is a privileged instruction. 
If register R6 contains %5252, the statement 
OUT %1120,R6 


will output the value %5252 to the "port" $1120. 
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OUTD 


Output and Decrement 


OUTD dst,src,r dsits .ImR 
OUTDB sre? ER 


INSTRUCTION FORMAT: (F6.4) 


W/B: 
OPERATION: 
FLAGS: 
CYCLES: 
NOTE: 
EXAMPLE: 
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dst <- sre 
AUTODECREMENT src {-l if byte, -2 if word} 
ca rp ed 


This instruction is used for block output of 
strings of data. The contents of the memory 
location addressed by the source register are 
loaded into the I/O location addressed by the 
destination register. 1/0 addresses are always 16 
bits. The source register is then decremented by 
one if OUTDB, or by two if OUTD, thus moving the 
pointer to the previous element in the string. The 
word register specified by "r" (used as a counter) 
is then decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte 
21: 


This is a privileged instruction. 


In segmented mode, if register R2 contains 

the 1/0 address $0030, register RR6 contains 
12005552 (segment $12, offset %5552), the word at 
memory location %12005552 contains %1234, and 
register R8 contains %1001, the statement 


OUTD @R2,@RR6,R8 
will output the value %1234 to "port" %0030, and 


leave the value %$12005550 in RR6, and %1000 in R8. 
Register R2 will not be affected. 


OUTI 


Output and Increment 


OUTI -~dst;)sre,r dst: IR 
OUTIB src: IR 


INSTRUCTION FORMAT: (F6.4) 


welsh 
Peet t,t, Pee 


OPERATION: dst <- src 
AUTOINCREMENT src {+l if byte, +2 if word} 
r <= r= 1 


This instruction is used for block output of 
strings of data. The contents of the memory 
location addressed by the source register are 
loaded into the I/O location addressed by the 
destination register. I/O addresses are always 16 
bits. The source register is then incremented by 
one if OUTIB, or by two if OUTI, thus moving the 
pointer to the next element in the string. The 
word register specified by "r" (used as a counter) 
is then decremented by one. 

FLAGS: Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 

cleared otherwise 

Unaffected 

Unaffected 


CYCLES: Word/Byte 


NOTE: This is a privileged instruction. 


<nnoa 


mo 


EXAMPLE: This instruction is used in a "loop" 
of instructions which outputs a string of data, but 
an intermediate operation on each element is 
required. The following sequence outputs a string 
of 80 ASCII characters (bytes) with the most 
significant bit of each byte set or reset to 
provide even parity for the entire byte. 
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OUTI 


Output and Increment 


LD 

LD 

LD 
LOOP: 

TESTB 

JR 

SETB 
EVEN: 

OUTIB 

JR 
DONE: 
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R1,#PORT 
R2,#SRCSTART 
R3, #80 


@R2 
PE, EVEN 
@R2,#7 


@R1,@R2,R3 
NOV, LOOP 


!Load I/O address! 
!Load start of string! 
!Initialize counter! 
!'Test byte parity! 


!Force even parity! 


!Output next byte! 
!Repeat until counter=0! 


POP dst,src dsterR, LR, DA, x 
POPL sre: IR 


INSTRUCTION FORMAT: (B2:..1) 


W 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


ee 
o 
o 
a 
g 
oO 
Or 
oo 
H 
wma 
| 


mode dst src 


IR 


Te 1 ea] ee 01 DA IR (dst field=0) 
eee 


Xx IR (dst field<>0) 


dst <- sre 
AUTOINCREMENT src {+2 if word, +4 if long} 


The contents of the location addressed by the source 
register (a “stack pointer") are loaded into the desti- 
nation. The source register is then incremented by a 
value which equals the size in bytes of the destination 
operand, thus removing the top element of the "stack" by 
changing the stack pointer. Any register except RO (or 
RRO) can be used as a stack pointer. 


No flags affected 


dst Word Long 
NS’ SS ~SEL NS “SS~ “SL 
R 8 -- -- 12 -- -- 
IR 12 -- -- LB? acs 
DA 16 16 19 23) 23°" 26 
X L6° 26 19 28 23 26 


For POPL, the same register must not be used in 
both the source and destination addressing mode 
designators. 


If register R12 (a "Stack pointer") contains %1000, 
the word at location $1000 contains %0055, and reg- 
ister R3 contains %0022, the statement 

POP R3,@RI12 


will leave the value $0055 in R3 and the value %1002 
in .Ri2 = 
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PUSH 


Push 


PUSH wdst,sre dst: IR 
PUSHL srer Rp IMiptir, DA» x 


INSTRUCTION FORMAT: CBZ. 2) 


W 


[mere itt a hal Loe 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 
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mode s 


ct 


sre 
10 IR R 
00 IR IR 


01 IR X (src field<>0) 


mode dst src 
00 R IM 


fees ee ee ee, ee 
wife 1, #1, %, ] 2 IR dA (sre field=0) 


AUTODECREMENT dst {-2 if word, -4 if long} 
dst <- src 


The contents of the destination register (a "Stack 
pointer") is decremented by a value which equals the 
size in bytes of the. destination operand. Then the 
source operand is loaded into the location addressed by 
the updated destination register, thus adding a new 
element to the top of the "stack" by changing the stack 
pointer. Any register except RO (or RRO) can be used 
as a stack pointer. 


No flags affected 


src Word Long 
NS SS _ SL NS SS SL 
R en a ee a 
IM L2e Say Se ia diiiceaeeaiie 
IR Ee = — 20S Ss ae 
DA ay Cael ane Oy 2d 424 
xX Lae 4 7 2 2A 2a 


For PUSHL, the same register must not be used 
in both the source and destination addressing 
mode designators. 


If register R12 (a "Stack pointer") contains %1002, 
the word at location $1000 contains %0055, and reg- 
ister R3 contains %0022, the statement 


PUSH @R12,R3 


will leave the value %0022 in location %1000 and the 
value $1000 in R12. 


RES 


Reset Bit 
RES dst,srce GSits Ryo ER, DAyaX 
RESB sres R; IM 
INSTRUCTION FORMAT: (F1.2) 
mode dst src 
w/e:[mae[ eo fe] Tee, | 10 ROW 
00 IR IM (dst field<>0) 
01 DA IM (dst field=0) 
01 xX IM (dst field<>0) 
(F6.3) 
dst sre 
R R 


OPERATION: dst(srce) <- 0 


Clears the specified bit within the destination operand 
without affecting any other bits in the destination. 

The source (the bit number) can be specified as either 
an immediate value, or as a word register which contains 
the value. In the second case, the destination operand 
must be a register, and the source operand must be RO 
through R7 for RESB, or RO through R15 for RES. The 

bit number is a value from 0 to 7 for RESB, or 0 to 15 
for RES, with 0 indicating the least significant bit. 


FLAGS: No flags affected 
CYCLES: dst sre Word/Byte 
NS Ss" ‘SL 
R IM 4 ==, == 
IR IM == = 
DA IM 13- Ape ke 
X IM ay apALs ley! 
R R LO)» eel See 
NOTE: Only the lower four bits of the source operand are 


used to specify the bit number for RES, while only the 
lower three bits of the source operand are used with 

RESB. When the source operand is an immediate value, the 
"Src field" in the instruction format encoding contains the 
bit number in the lowest four bits for RES, or the lowest 
three bits for RESB. 


EXAMPLE: If register RL3 contains %$B2 (10110010), the statement 
RESB- RL3,#1 


will leave the value BO (10110000) in RL3. 
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RESFLG 


Reset Flag 


RESFLG flag flage- C352, Sl@p, Vv 


INSTRUCTION FORMAT: (E951) 


OPERATION: FLAGS(4:7) <- FLAGS(4:7) AND NOT instruction(4:7) 


Any combination of the C, Z, S, P or V flags are 
cleared to zero if the corresponding bit in the 
instruction is one. If the corresponding bit in 
the instruction is zero, the flag will not be 
affected. All other bits in the FLAGS register are 
unaffected. Note that the P and V flags are 
represented by the same bit. There may be one, 
two, three or four operands in the assembly 
language statement, in any order. 


C: Cleared if specified; unaffected otherwise 

Z: Cleared if specified; unaffected otherwise 

S: Cleared if specified; unaffected otherwise 
P/V: Cleared if specified; unaffected otherwise 

D: Unaffected 

H: Unaffected 


CYCLES: e 


EXAMPLE: If the C, S, and V flags are all set (=1), 
and the Z flag is clear (=0), the statement 


RESFLG C, V 


will leave the S flag set (=1), and the C, Z, 
and V flags cleared (=0). 
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RET 


Return from Procedure 


RET cc 


INSTRUCTION FORMAT: (F9.4) 


OPERATION: Nonsegmented Segmented 
if cc is true then if cc is true then 
PC <- @SP PC <- @SP 
SP <- SP + 2 sP <- SP + 4 


This instruction is used to return to a previously 
executing procedure at the end of a procedure entered by 
a CALL or CALR instruction. If the condition specified 
by "cc" is true, then the contents of the location 
addressed by the processor stack pointer are popped into 
the program counter (PC). The next instruction executed 
is that addressed by the new contents of the PC. See 
section 3.2.1 for a list of condition codes. The stack 
pointer used is R15 if nonsegmented, or RR14 if segmented. 
Tf the condition code is false, then control falls through 
to the instruction following the RET instruction. 


FLAGS: No flags affected 
CYCLES: Address 
NS” “SS? “Sh 
10 -- 13 (return is taken) 
Te f= 7 (return not taken) 
EXAMPLE: In nonsegmented mode, if the program counter contains 


$2550, the stack pointer (R15) contains $3000, location 
23000 contains %1004, and the Z flag is clear, then the 
statement 


RET NZ 
will leave the value %3002 in the stack pointer and 


the program counter will contain 21004 (the address of 
the next instruction to be executed). 


195 


RL 


Rotate Left 


RL dst,srce dst: ® 
RLB sre: IM 


INSTRUCTION FORMAT: (Pt 61) 


mode dst src 


we: [rete bl tee] 10 OR TH 


OPERATION: 
FLAGS: [ae 
Z3 
Ss? 
Ve 
Dis 
Hie 
CYCLES’: 
EXAMPLE: 
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(Perform operation once if s=0, twice if s=1) 


Cc <- dst(msb) 
dst(0) <- dst(msb) 
dst(n+l) <- dst(n) {n is 0 to msb-1} 


The contents of the destination operand are rotated left 
one bit position if the source operand is 1, or two bit 
positions if the source operand is 2. The source operand 
may be omitted from the assembly language statement and 
thus defaults to the value 1. The most significant bit 
of the destination operand is moved to the bit 0 position 
and also replaces the C flag. 


a 15 0 = 
Byte:[c] 


Set if the last bit rotated from the most significant 
bit position was 1; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the most significant bit of the result is set; 
cleared otherwise 

Set if arithmetic overflow occurs, that is, if the 

sign of the destination changed during rotation; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 


6 (once) 


/ (twice) 
If register RH5 contains %88 (10001000), the statement 
RLB RH5 


will leave the value $11 (60010601) in RH5 and the 
carry flag will be set to one. 


RLC 


Rotate Left through Carry 


RLC dst,srec dst: R 
RLCB Sree) 2M 


INSTRUCTION FORMAT: (Ee) 


mode dst src 


we:feel eee ese] 10 OR Te 


OPERATION: 
FLAGS: Gis 
Hig 
Ss 
V: 
De 
ies 
CYCLES: 
EXAMPLE: 


(Perform operation once if s=0, twice if s=1) 


ase) <=" 
Cc <- dst(msb) 
dst(nt+l) <- dst(n) {n is 0 to msb-1} 


The contents of the destination operand with the C flag 
are rotated left one bit position if the source operand 
is 1, or two bit positions if the source operand is 2. 
The source operand may be omitted from the assembly lang- 


“uage statement and thus defaults to the value 1. The 


most significant bit of the destination operand replaces 
the C flag and the previous value of the C flag is moved 
to the bit 0 position of the destination. 


15 0 
oa Ct eee 
7 0 
Byte: loteolsozorss abl 


Set if the last bit rotated from the most significant 
bit position was 1; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the most Significant bit of the result is set; 
cleared otherwise 

Set if arvthmetic overtlow oceurs, that Ps7eri the 

sign of the destination changed during rotation; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
6 (once) 


7 (twice) 


If the carry flag is clear (=0) and register RO 
contains S800F (1000000000001111), the statement 


RLC RO,#2 


will leave the value %U03D (0000006060111101) in 
RO and clear the carry flag. 
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RLDB 


Rotate Left Digit 


RLDB dst,src disites, VR 


INSTRUCTION FORMAT: (F221) 


B: | mode | 1 ( Coed cic sre | pdt 10 R ae 


OPERATION: sre(0.3) <= dstc0:3) 
sre(4e7) <= srei(03) 
dst(0:3) <- sre(4:7) 


Rotates to the left BCD digits between source and 
destination byte operands. Simultaneously, the lower 
digit of destination is moved to the lower digit of 
source, the lower digit of source is moved to the upper 
digit of source, and the upper digit of source is moved 
to the lower digit of destination. The result is the 
destination after the operation, whose upper digit is 
unaffected. In multiple-digit BCD arithmetic, this 
instruction can be used to shift to the left a string 
of BCD digits, thus multiplying it by a power of ten. 


ast : Ee eae sre 


C: Unaffected 

Z: Set if the result is zero; cleared otherwise 

S: Set if the most significant bit of the result is set; 
cleared otherwise 

V: Unaffected 

D: Unaffected 

H: Unaffected 


FLAGS: 


GYELES.: Byte 
9 


NOTE: The same register must not be used in both the source 
and destination eddressing mode designators. 
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RLDB 


Rotate Left Digit 


EXAMPLE: If location 100 contains the BCD digits 0,1 (00000061), 
location 101 contains 2,3 (00100011), and location 102 
contains 4,5 (01000101) 


160 101 02 


[els] 


the sequence of statements 


LD R3,#3 !Set loop counter for 3 bytes (6 
digits) ! 
LD R2,#102 !Set pointer to low-order digits! 
CLRB RH1 !'Zero-fill low-order digit! 
LOOP: 
LDB RL1,@R2 !Get next two digits! 
RLDB RH1,RL1 !Shift digits left one position! 
LDB @R2,RL1 !Replace shifted digits! 
DEC R2 !Advance pointer! 
DJNZ R3,LOOP !Repeat until counter is zero! 


will leave the digits 1,2 (00010610) in location 100, the 
digits 3,4 (00110100) in location 101, and the digits 5,0 
(01010000) in location 102. 


100 101 102 


fare 
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RR 


Rotate Right 
RR dst,src dst: R 
RRB ses; EM 


INSTRUCTION FORMAT: (eS) 


were he se] TO “RTM 


OPERATION: 
FLAGS: Cs 
be 
Sit 
V: 
Dis 
Hie 
CYCLES: 
EXAMPLE: 
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mode dst src 


(Perform operation once if s=0, twice if s=1) 


Cc <- dst(0) 
dst(msb) <- dst(0) 
dst(n) <- dst(n+tl) {n is 0 to msb-1} 


The contents of the destination operand are rotated 
right one bit position if the source operand is l, or 
two bit positions if the source operand is 2. The least 
significant bit of the destination operand is moved to 
the most significant bit and also replaces the C flag. 
The source operand may be omitted from the assembly 
language statement and thus defaults to the value l. 


Word: eS ~ : 


Set if the last bit rotated from the least significant 
bit position was 1; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the most significant bit of the result is set; 
cleared otherwise 

Set if arithmetic overflow occurs, that is, if the 

sign of the destination changed during rotation; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
6 (once) 
4] (twice) 

If register RL6 contains %31 (00110001), the statement 
RRB RL6 


will leave the value %98 (10011000) in RL6 and the 
carry flag will be set to one. 


RRC 


Rotate Right through Carry 


RRC ast ;sre dst k: 
RRCB SiGe ro 


INSTRUCTION FORMAT: GB) 


we: Peper Pe] 10 OR 


OPERATION: 
FLAGS: Crs 
Gis 
Ss 
Wiz 
Ds 
His 
CY CEES 


(Perform operation once if s=0, twice if s=1) 


dst(msb) <- C 
c <- dst(0) 
dst(n) <- dst(n+l) {n is 0 to msb-1} 


The contents of the destination operand with the C flag 
are rotated right one bit position if the source operand 
is 1, or two bit positions if the source operand is 2. 
The least significant bit of the destination operand 
replaces the C flag and the previous value of the C flag 
is moved to the most significant bit position of the 
destination. The source operand may be omitted from the 
assembly language statement and thus defaults to the 
value l. 


Set if the last bit rotated from the least significant 
bit position was 1; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the most significant bit of the result is set; 
cleared otherwise 

Set if arithmetic overflow occurs, that is, if the 

sign of the destination changed during rotation; cleared 
otherwise 

Unaffected 

Unaffected 


Word/Byte 
6 (once) 


Th (twice) 


201 


RRC 


Rotate Right through Carry 


EXAMPLE: If the carry flag is clear (=0) and the register RO 
contains %00DD (0000000011011101), the statement 


RRC RO,#2 


will leave the value %8037 (1000000000110111) in RO 
and clear the carry flag. 
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RRDB 


Rotate Right Digit 


RRDB dst,src dst: R 


INSTRUCTION FORMAT: (F2.1) 


a:[eep es] ue, | ao Rk oF 


OPERATION: src(4:7) <- dst(0:3) 
src(0:3) <- src(4:7) 
dst(0:3) <- src(0:3) 


Rotates to the right BCD digits between source and 
destination byte operands. Simultaneously, the lower 
digit of destination is moved to the upper digit of 
source, the upper digit of source is moved to the lower 
digit of source, and the lower digit of source is moved 
to the lower digit of destination. The result is the 
destination after the operation, whose upper digit is 
unaffected. In multiple-digit BCD arithmetic, this 
instruction can be used to shift to the right a string 
of BDC digits, thus dividing it by a power of ten. 


FLAGS: 


C: Unaffected 

Z: Set if the result is zero; cleared otherwise 

S: Set if the most significant bit of the result is set; 
cleared otherwise 


V: Unaffected 
D: Unaffected 
H: Unaffected 


CYCLES: Byte 


NOTE: The same register must not be used in both the source 
and destination addressing mode designators. 
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RRDB 


Rotate Right Digit 


EXAMPLE: 
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If location 100 contains the BCD digits 1,2 (00010010), 
location 101 contains 3,4 (00110100), and location 102 
contains 5,6 (01010110) 


100 101 102 


Ge) Cee Tae 


the sequence of statements 


LD R3,#3 !Set loop counter for 3 bytes (6 
digits) ! 

LD R2,#100 !Set pointer to high-order digits! 

CLRB RHI !'Zero-fill high-order digit! 


LOOP: 
LDB RL1,@R2 !Get next two digits! 
RRDB RH1,RL1 !Shift digits right one position! 
LDB @R2,RL1 !Replace shifted digits! 
INC R2 !Advance pointer! 
DJNZ R3,LOOP !Repeat until counter is zero! 


will leave the digits 0,1 (00000001) in location 100, the 
digits 2,3 (00100011) in location 101, and the digits 4,5 


(01000101) in location 102. 
100 101 102 


pe EL] 


SBC 


Subtract with Carry 


SBC dst,src dst: R 
SBCB srce 
INSTRUCTION FORMAT: (F2.1) 


mode dst src 
W/B: mode 11011 src dst 10 R R 


operation: [ree] el 


The source operand, along with the setting of the carry 
flag, is subtracted from the destination operand and the 
result is stored in the destination. The contents of the 
source are not affected. Subtraction is performed by 
adding the two's complement of the source operand to the 
destination operand. In multiple precision arithmetic, 
this instruction permits the carry ("borrow") from the 
subtraction of low-order operands to be subtracted from 
the subtraction of high-order operands. 


FLAGS: C: Cleared if there is a carry from the most significant 

bit of the result; set otherwise, indicating a "borrow" 

Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 

V: Set if arithmetic overflow occurs, that is, if the 
operands were of opposite signs and the sign of the 
result is the same as the sign of the source; cleared 
otherwise 

D: SBC - unaffected; SBCB - set 

H: SBC - unaffected; SBCB - cleared if there is a carry 
from the most significant bit of the low-order four 
bits of the result; set otherwise, indicating a 


"borrow" 
CYCLES: Word/Byte 
5 
EXAMPLE: Long subtraction may be done with the following 


instruction sequence, assuming RO,R1 contain one 
operand and R2,R3 contain the other operand: 


SUB R1,R3 !subtract low-order words! 
SBC RO,R2 !subtract carry and high-order words! 


If RO contains %0038, Rl contains %4000, R2 contains 
000A and R3 contains %F000, then the above two in- 

structions leave the value %002D in RO and %5000 in 

Ri: 
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SC 


System Call 


SC. Jone sresoiM 


INSTRUCTION FORMAT: (F9..5) 


PPR eae 


OPERATION: Nonsegmented Segmented 
SP <- SP - 4 SP <- SP - 6 
@SP <- PS @SP <- PS 
SP <- SP - 2 SP <- SP - 2 
@SP <- instruction @SP <- instruction 
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PS <- System Call PS PS <- System Call PS 


This instruction is used for controlled access to operating 
system software in a manner similar to a trap or interrupt. 
The current program status (PS) is pushed on the system 
processor stack, and then the instruction itself is pushed 
which includes the source operand (an 8-bit value). The 

PS includes the Flags and Control Word (FCW), and the up- 
dated program counter (PC). (The updated program counter 
value used is the address of the first instruction byte 
following the SC instruction.) 


The system stack pointer is always used (R15 if nonsegmen- 
ted, or RR14 if segmented), regardless of whether system 
Or normal mode is in effect. The new PS is then loaded 
from the Program Status block associated with the System 
Call trap (see section 1.6.4), and control is passed to 
the procedure whose address is the program counter value 
contained in the new PS. This procedure may inspect the 
source operand on the top of the stack to determine the 
Particular software service desired. 


The following figure illustrates the format of the saved 
program status in the system stack: 


NONSEGMENTED SEGMENTED 
LOW ADDRESS 


sP 
APteR——>| INSTRUCTION 
PC SEG. NO. 
PC OFFSET 
Fo ee eee 
BEFORE. 


HIGH ADDRESS 


SP 
AFTER INSTRUCTION 


SP 
BEFORE 


FLAGS: 


CYCLES: 


NOTES: 


EXAMPLE: 


SC 


System Call 


No flags affected 


Address 
NS SS SL 
33 -- 39 


The Z8001 version always executes the segmented mode 
of the System Call instruction, regardless of the 
current mode, and sets the Segmentation Mode bit (SEG) 
to segmented mode (=1) at the start of the SC in- 
struction execution. Both the Z8001 and 28002 ver- 
sions set the System/Normal Mode bit (S/N) to System 
mode (=1) at the start of the SC instruction execution. 
The status pins reflect the setting of these control 
bits during the execution of the SC instruction. 
However, the setting of SEG and S/N does not affect 
the value of these bits in the old FCW pushed on the 
stack. The new value of the FCW is not effective 
until the next instruction, so that the status pins 
will not be affected by the new control bits until 
after the SC instruction execution is completed. 


The "src field" in the instruction format encoding 
contains the source operand. The "sre field" values 
range from 0 to 255 corresponding to the source values 
OstOs 255s 


In the nonsegmented 28002 version, if the contents of 
the program counter are %$1000, the contents of the 
system stack pointer (R15) are $3006, and the program 
counter value associated with the System Call trap in 
the Program Status Area is %2000, the statement 


sc #3 '!System call,request code=3! 


causes the system stack pointer to be decremented to 
$3000. Location %3000 contains %7F03 (0111111100000011, 
the SC instruction). Location %3002 contains the old 
FCW, and location %3004 contains %1002 (the address of 
the instruction following the SC instruction). System 
mode is in effect, and the program counter contains the 
value %2000, which is the start of a System Call trap 
handler. 


207 


SDA 


Shift Dynamic Arithmetic 


SDA dst,sre dists i 
SDAB srct -R 
SDAL 

INSTRUCTION FORMAT: (F6.6) 


OPERATION: Right repeat sre times: 
dst(msb) <- dst(msb) 
dst(n) <- dst(nt+l) {n is 0 to msb-1} 
Cc <- dst(0) 


Left repeat src times: 

ast((0) a#<=-20 

dst(n+l) <- dst(n) {n is 0 to msb-1} 
Cc <- dst(msb) 


The destination operand is shifted arithmetically right 

or left the number of bit positions specified by the 
source operand (a word register). The shift count varies 
from -8 to +8 for SDAB, from -16 to +16 for SDA, and from 
-32 to +32 for SDAL, where a negative value is a right 
shift and a positive value is a left shift. A shift of 
zero positions does not affect the destination; however, 
the flags are set according to the destination value. The 
Sign bit is replicated in shifts to the right, and the C 
flag is loaded from bit 0 of the destination. The least 
Significant bit is filled with 0 in shifts to the left, and 
the C flag is loaded from the sign bit of the destination. 


Right Left 


it 0 7 it) 
word on Ls is pg Den Lo 


0 
Long: ee 


15 0 15 0 


ee 


n=0,2,4,.2.,14 n=0, 24, -20,14 
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SDA 


Shift Dynamic Arithmetic 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 


<q nn 


Set if the last bit shifted from the destination 
was 1, cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 
Set if arithmetic overflow occurs, that is, if the 
sign of the destination changed during shifting; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte Long 
15+3*n 15+3*n (n=number of bit positions, 


where 0 is equivalent to 1) 


The source operand is represented as a 16-bit two's 
complement value. For each operand size, the 
operation is undefined if the value is not in the 
range specified above. 


If register R5 contains %C705 (1100011100000101) and 
register Rl contains -2 (%FFFE or PPT VAL VIA LLL LO) ¢ 
the statement 


SDA R5,R1 
performs an arithmetic right shift of two bit 


positions, leaves the value $F1Cl1 (1111000111000001) 
in R5, and clears the carry flag. 
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SDL 


Shift Dynamic Logical 


SDL dst,sre dst: R 
SDLB Sree: RR 
SDLL 


INSTRUCTION FORMAT: (F6.6) 


mode dst src 
10 R 


OPERATION: 
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Right repeat src times: 

dst(msb) <- 0 

dst(n) <- dst(nt+l) {n is 0 to msb-1} 
Ci <=) disiti(0) 


Left repeat src times: 

astito0) <= 0 

dst(n+l) <- dst(n) {n is 0 to msb-1} 
Cc <- dst(msb) 


The destination operand is shifted logically right or 
left the number of bit positions specified by the source 
operand (a word register). The shift count varies from 
-8 to +8 for SDLB, from -16 to +16 for SDL, and from -32 
to +32 for SDLL, where a negative value is a right shift 
and a positive value is a left shift. A shift of zero 
positions does not affect the destination; however, the 
flags are set according to the destination value. The 
most significant bit is filled with 0 in shifts to the 
right, and the C flag is loaded from bit 0 of the des- 
tination. The least significant bit is filled with 0 

in shifts to the left, and the C flag is loaded from the 
most Significant bit of the destination. 


SDL 


Shift Dynamic Logical 


Right Left 


yee: ef A] ER{ 
15 ) 15 0 
words ef) ER 


15 Y) 15 0 


a 


n=0,2,4,.-+.,14 n=0,2,4,...,14 


FLAGS: C: Set if the last bit shifted from the destination was 1; 
cleared otherwise ; 
Z: Set if the result is zero; cleared otherwise 
S: Set if the most significant bit of the result is set; 
cleared otherwise 
Undefined 
Unaffected 
Unaffected 


mos 


CYCLES: Word/Byte Long 
L543" in 15+3*n (n=number of bit positions, 
where 0 is equivalent to 1) 


NOTE: The source operand is represented as a 16-bit two's 
complement value. For each operand size, the 
operation is undefined if the value is not in 
the range specified above. 


EXAMPLE: If register RL5 contains %B3 (10110011) and register 
Rl contains 4 (0000000000000100), the statement 


SDLB- RL5,Rl 
performs a logical left shift of four bit positions, 


leaves the value %30 (00110000) in RL5, and sets the 
carry flag. 
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SET 


Set Bit 
SET dst,srce dsits > ER; DA, X 
SETB src: R, IM 
INSTRUCTION FORMAT: (ELJ2) 
mode st Sire 
W/s: [ree [eee | io ok TW 
meee | i ee es a ae ee ey 
01 DA IM (dst field=0) 
01 X IM (dst field<>0) 
(F6.3) 
st—-sre 
R R 


OPERATION: 


FLAGS: 


CYCLES: 


NOTE: 


EXAMPLE: 
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dst(sre) <- l 


Sets the specified bit within the destination operand 
without affecting any other bits in the destination. 

The source (the bit number) can be specified as either 
an immediate value, or as a word register which contains 
the value. In the second case, the destination operand 
Must be a register, and the source operand must be RO 
through R7 for SETB, or RO through R15 for SET. ‘The bit 
number is a value from 0 to 7 for SETB or O to 15 for 
SET, with 0 indicating the least significant bit. 


No flags affected 


dst src Word/Byte 


NS SS_ SL 
R IM al 
IR IM 1 eas 
DA IM 3h ae 2G 
xX IM ae alrae IP? 
R R B10) haem pn 


Only the lower four bits of the source operand are used 
to specify the bit number for SET, while only the lower 
three bits of the source operand are used with SETB. 
When the source operand is an immediate value, the "src 
field" in the instruction format encoding contains the 
bit number in the lowest four bits for SET, or the 
lowest three bits for SETB. 


If register RL3 contains %B2 (10110010) and register R2 
contains the value 6, the statement 


SETB RL3,R2 


will leave the value $F2 (11110010) in RL3. 


SETFLG 


Set Flag 
SETFLG flag Pliage Cs. oe Sp By ¥ 
INSTRUCTION FORMAT: (F9.1) 
OPERATION: FLAGS(4:7) <- FLAGS(4:7) OR instruction(4:7) 


Any combination of the C, Z, S, P or V flags are 
set to one if the corresponding bit in the 
instruction is one. If the corresponding bit in 
the instruction is zero, the flag will not be 
affected. All other bits in the FLAGS register are 
unaffected. Note that the P and V flags are 
represented by the same bit. There may be one, 
two, three or four operands in the assembly 
language statement, in any order. 


FLAGS C: Set if specified; unaffected otherwise 
Z: Set if specified; unaffected otherwise 
S: Set if specified; unaffected otherwise 
P/V: Set if specified; unaffected otherwise 
D: Unaffected 
H: Unaffected 
CYCLES: Tt 
EXAMPLE: If the C, Z, and S flags are all clear (=0), 


and the P flag is set (=l), the statement 
SETFLG C 


will leave the C and P flags set (=1), and 
the Z and S flags cleared (=0). 
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SIN 


Special Input 
SIN dst,srcec dst: R 
SINB sre: DA 
INSTRUCTION FORMAT: (a7 eB 


Wes) a 04 tk ee, ee eee 


OPERATION: dst <= src 


The contents of the source operand are loaded into the 
destination. I/O addresses are always 16 bits. This 
instruction is used to load information from the Memory 
Management Unit. 


FLAGS: No flags affected 
CYCLES: Word/Byte 
i 
NOTES: This is a privileged instruction. 


The status pins indicate a special I/O reference. 
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SIND 


Special Input and Decrement 


SIND dst,isre,r dst: IR 
SINDB sre: IR 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 
FLAGS: C: 
Vii 
S: 
Ws 
D: 
He 
CYCLES: 
NOTES: 


ast: <= src 
AUTODECREMENT dst {-1l if byte, -2 if word} 
r<-r-l 


This instruction is used for block input of strings of 
data, typically status information from the Memory 
Management Unit. The contents of the I/O location 
addressed by the source register are loaded into the 
memory location addressed by the destination register. 
I/O addresses are always 16 bits. The destination reg- 
ister is then decremented by one if SINDB, or by two if 
SIND, thus moving the pointer to the previous element in 
the string. The word register specified by "r" (used as 
a counter) is then decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte 


This is a privileged instruction. 


The status pins indicate a special I/O reference. 
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SINDR 


Special Input, Decrement and Repeat 


SINDR: «dst.,sre,r dst: IR 
SINDRB Sires “LR 
INSTRUCTION FORMAT: (F6.4) 


Q 
n 
ct 
n 
La) 
Q 


H 
wD 

H 
4 
as 


OPERATION: dst <- src 
AUTODECREMENT dst {-l if byte, -2 if word} 
TA Se) cota 
repeat until r = 0 


This instruction is used for block input of strings of 
data, typically status information from the Memory 
Management Unit. The contents of the I/O location 
addressed by the source register are loaded into the 
memory location addressed by the destination register. 
I/O addresses are always 16 bits. The destination 
register is then decremented by one if SINDRB, or by 
‘two if SINDR, thus moving the pointer to the previous 
element in the string. The word register specified by 
"r" (used as a counter) is then decremented by one. 
The entire operation is repeated until the result of 
decrementing r is zero. This instruction can input 
from 1 to 65536 bytes or 32768 words (the value for r 
Must not be greater than 32768 for SINDR). 
FLAGS: Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


ee ee 08 ee oo ce 


TO AINNOA 


CYCLES: Word/Byte 


11+10*n (n=number of data elements transferred) 
NOTES: This is a privileged instruction. 
The status pins indicate a special I/O reference. 


This instruction can be interrupted after each exe- 
cution of the basic operation. The program counter 
value of the start of this instruction is saved before 
the interrupt request is accepted, so that the in- 
struction can be properly resumed. Seven more cycles 
should be added to this instruction's execution time 
for each interrupt request that is accepted. 
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SINI 


Special Input and Increment 


SINE dst, suey dst: IR 
SINIB sre? GR 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 
ELAGSs: G's 
Z: 
oye 
Vs 
IDR 
He 
CYCLES: 
NOTES: 


dst <= src 
AUTOINCREMENT dst {+l if byte, +2 if word} 
r <= r — i 


This instruction is used for block input of strings 
of data, typically status information from the 
Memory Management Unit. The contents of the I/O 
location addressed by the source register are loaded 
into the memory location addressed by the destination 
register. I/O addresses are always 16 bits.. The 
destination is then incremented by one if SINIB, 

or by two if SINI, thus moving the pointer to the 
next element in the string. The word register 
specified by "r" (used as a counter) is then 
decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte 


This is a privileged instruction. 


The status pins indicate a special I/O reference. 
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SINIR 


Special Input, Increment and Repeat 


SINTRs 7 dst isre pr dst: IR 
SINIRB sre: IR 
INSTRUCTION FORMAT: (F6.4) 


OPERATION: dst <= sre 
AUTOINCREMENT dst {+l if byte, +2 if word} 
Yr <=" = 1 
repeat until r = 0 


This instruction is used for block input of strings 
of data, typically status information from the 
Memory Management Unit. The contents of the I/0 
location addressed by the source register are loaded 
into the memory location addressed by the des- 
tination register. 1/0 addresses are always 16 bits. 
The destination register is then incremented by one 
if SINIRB, or by two if SINIR, thus moving the pointer 
to the next element in the string. The word register 
specified by "r" (used as a counter) is then 
decremented by one. The entire operation is repeated 
until the result of decrementing r is zero. This 
instruction can input from 1 to 65536 bytes or 32768 
words (the value -for r must not be greater than 32768 
for SINIR),. 
FLAGS: : Unaffected 
: Undefined 
Unaffected 
: Set 
: Unaffected 
: Unaffected 


CYCLES: Word/Byte 
11+10*n (n=number of data elements transferred) 


NOTES: This is a privileged instruction. 
The status pins indicate a special I/O reference. 


This instruction can be interrupted after each 
execution of the basic operation. The program 
counter value of the start of this instruction is 
saved before the interrupt request is accepted, 
so that the instruction can be properly resumed. 
Seven more cycles should be added to this in- 
struction's execution time for each interrupt 
request that is accepted. 
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SLA 


Shift Left Arithmetic 


SLA dst,src dst: R 
SLAB src: IM 
SLAL 


INSTRUCTION FORMAT: easyeell), 


mode dst src 
R 


we:ferl hl, fe] 10 Ti 


src 


OPERATION: 


repeat src times: 

ds#(0)) <= 0 

dst(nt+l) <- dst(n) {n is 0 to msb-1} 
c <- dst(msb) 


The destination operand is shifted arithmetically left 
the number of bit positions specified by the source 
operand. For SLAB, the source is in the range 0 to 8; 
for SLA, the source is in the range 0 to 16; for SLAL, 
the source is in the range 0 to 32. A shift of zero 
positions does not affect the destination; however, 
the flags are set according to the destination value. 
The least significant bit of the destination is filled 
with 0, and the C flag is loaded from the sign bit 

of the destination. This instruction performs a signed 
multiplication of the destination by a power of two 
with overflow indication. The source operand may be 
omitted from the assembly language statement and 

thus defaults to the value l. 


ia 0 


pyte: [off 


15 0 


15 0 


15 0 


Riae oe ELN Ta oe 


n=0,2,4,...,14 
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SLA 


Shift Left Arithmetic 


FLAGS: C: Set if the last bit shifted from the destination was 1; 

cleared otherwise 

Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 

: Set if arithmetic overflow occurs, that is, if the 

sign of the destination changed during shifting; cleared 
otherwise 

D: Unaffected 

H: Unaffected 


CYCLES: Word/Byte Long 
V3+3*n 13+3*n (n=number of bit positions, 
where 0 is equivalent to 1) 
NOTE: The "src field" is encoded in the instruction format as 


the 16-bit two's complement positive value of the source 
operand. For each operand size, the operation is undefined 
if the source operand is not in the range specified above. 
EXAMPLE: If register pair RR2 contains %1234ABCD, the statement 
SLAL RR2,#8 


will leave the value %34ABCD0O0 in RR2 and clear the 
carry flag. 
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SLL 


Shift Left Logical 


SLL dst,sre dst: R 
SLLB Sines aM 
SLLL 


INSTRUCTION FORMAT: (BS. 1) 


w/e: [ree] th] eee] 10 oR IN 


mode dst src 


OPERATION: 


repeat src times: 

dst(0) <= 0 

dst(nt+l) <- dst(n) {n is 0 to msb-1} 
C <- dst(msb) 


The destination operand is shifted logically left the 
number of bit positions specified by the source operand. 
For SLLB, the source is in the range 0 to 8; for SLL, 
the source is in the range 0 to 16; for SLLL, the source 
is in the range 0 to 32. A Shift of zero positions 
does not affect the destination; however, the flags 

are set according to the destination value. The least 
significant bit of the destination is filled with 0, 

and the C flag is loaded from the most significant bit 
of the destination. This instruction performs an 
unsigned multiplication of the destination by a power 

of two. The source operand may be omitted from the 
assembly language statement and thus defaults to 

the value l. 


if 0 


15 tt) 


15 i) 


15 0 


cS ae 


=O) pin Sa iae ae! 
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SLL 


Shift Left Logical 


FLAGS: C: Set if the last bit shifted from the destination was 1; 
cleared otherwise 
Z: Set if the result is zero; cleared otherwise ; 
S: Set if the most significant bit of the result is set; 
cleared otherwise 
Undefined 
Unaffected 
Unaffected 


mod 


CYCLES: Word/Byte Long 
1343" nH 134+3*n (n=number of bit positons, 
where 0 is equivalent to 1) 


NOTE: The "src field" is encoded in the instruction format 
as the 16-bit two's complement positive value of the 
source operand. For each operand size, the operation 
is undefined if the source operand is not in the 
range specified above. 


EXAMPLE: If register R3 contains %4321 (0100001100100001), 
the statement 


SLL R3,#1 


will leave the value %8642 (1000011001000010) in R3 
and clear the carry flag. 
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SOTDR 


Special Output, Decrement and Repeat 


SOTDR dst,Src,r dst: IR 
SOTDRB sree ER 


INSTRUCTION FORMAT: (F6.4) 


Hi 
be) 
Loa! 
be) 
las 


OPERATION: 
FLAGS: Cs: 
Zs 
Sis 
V: 
pis 
H: 
CYCLES: 
NOTES: 


dst <- sre 

AUTODECREMENT src {-l if byte, -2 if word} 
eo <= f= A 

repeat until r = 0 


This instruction is used for block output of strings of 
data, typically information to the Memory Management 
Unit. The contents of the memory location addressed 

by the source register are loaded into the I/O location 
addressed by the destination register. I/O addresses 
are always 16 bits. The source register is then decre- 
mented by one if SOTDRB, or by two if SOTDR, thus moving 
the pointer to the previous element in the string. The 
word register specified by "r" (used as a counter) is 
then decremented by one. The entire operation is re- 
peated until the result of decrementing r is zero. 

This instruction can output from 1 to 65536 bytes or 
32768 words (the value for r must not be greater than 
32768 for SOTDR). 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Word/Byte 
11+10*n (n=number of data elements transferred) 


This is a privileged instruction. 
The status pins indicate a special I/O reference. 


This instruction can be interrupted after each exe- 
cution of the basic operation. The program counter 
value of the start of this instruction is saved before 
the interrupt request is accepted, so that the 
instruction can be properly resumed. Seven more cycles 
should be added to this instruction's execution time 
for each interrupt request that is accepted. 
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SOTIR 


Special Output, Increment and Repeat 


SOTIR dst,sre,r dst: JLR. 

SOTIRB sree LR 
INSTRUCTION FORMAT: (F6.4) 

ast sre 


OPERATION: dst <- src 
AUTOINCREMENT src {+l if byte, +2 if word} 
r'<=i7 = 1} 
repeat until r = 0 


This instruction is used for block output of strings of 
data, typically information to the Memory Management 
Unit. The contents of the memory location addressed 
by the source register are loaded into the I/O location 
addressed by the destination register. I/O addresses 
are always 16 bits. The source register is then incre- 
mented by one if SOTIRB, or by two if SOTIR, thus moving 
the pointer to the next element in the string. The word 
register specified by "r" (used as a counter) is then 
decremented by one. The entire operation is repeated 
until the result of decrementing r is zero. This instruc- 
tion can output from 1 to 65536 bytes or 32768 words (the 
value for r must not be greater than 32768 for SOTIR). 
FLAGS: Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


ZToannoa 


CYCLES: Word/Byte 


11+10*n (n=number of data elements transferred) 
NOTES: This is a privileged instruction. 
The status pins indicate a special I/O reference. 


This instruction can be interrupted after each execution 
of the basic operation. The program counter value of 

the start of this instruction is saved before the in- 
terrupt request is accepted, so that the instruction can 
be properly resumed. Seven more cycles should be added to 
this instruction's execution time for each interrupt 
request that is accepted. 
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SOUT 


Special Output 


SOUT “dst;,Sre 
SOUTB 


INSTRUCTION FORMAT: (F7.2) 


wee ee ae 


OPERATION: dsit <="isre 


dst: DA 
Sres RK 
st sre 

DA R 


The contents of the source operand are loaded into 


the destination. 


I/O addresses are always 16 bits. 


This instruction is used to load information into 


the Memory Management Unit. 


FLAGS: No flags affected 


CYCLES: Word/Byte 


NOTES: This is a privileged instruction. 


The status pins indicate a special I/O reference. 
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SOUTD 


Special Output and Decrement 


SOUTD dst,src,r dst: IR 

SOUTDB sre: EIR 
INSTRUCTION FORMAT: (F6.4) 

dst src 


rt 
wees hf.) mm im R 
Peet ty Lat [eee | 


OPERATION: 
FLAGS: C 
Z 
Ss 
V 
D 
H 
CYCLES: 
NOTES: 
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dst, <= sre 
AUTODECREMENT src {-l if byte, -2 if word} 
C=. ae 


This instruction is used for block output of strings of 
data, typically information to the Memory Management 
Unit. The contents of the memory location addressed by 
the source register are loaded into the I/O location 
addressed by the destination register. I/0 addresses 
are always 16 bits. The source register is then decre- 
mented by one if SOUTDB, or by two if SOUTD, thus mov- 
ing the pointer to the previous element in the string. 
The word register specified by "r" (used as a counter) 
is then decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte 
2a) 


This is a privileged instruction. 


The status pins indicate a special I/O reference. 


SOUTI 


Special Output and Increment 


SOUTT. dst, sre,e dst: IR 
SOUTIB srics) DR 
INSTRUCTION FORMAT: (F6.4) 


r 
we: he, fe] I IR 


OPERATION: 
FLAGS: (2 
“ie 
Sis 
Vis 
D: 
Be 
CYCLES: 
NOTES: 


ast <= "sinc 
AUTOINCREMENT src {+l if byte, +2 if word} 
Pec Sa 


This instruction is used for block output of strings of 
data, typically information to the Memory Management 
Unit. The contents of the memory location addressed 

by the source register are loaded into the I/O location 
addressed by the destination register. I/O addresses 
are always 16 bits. The source register is then incre- 
mented by one if SOUTIB, or by two if SOUTI, thus mov- 
ing the pointer to the next element in the string. 

The word register specified by "r" (used as a counter) 
is then decremented by one. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
cleared otherwise 

Unaffected 

Unaffected 


Word/Byte 


This is a privileged instruction. 


The status pins indicate a special I/O reference. 
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SRA 


Shift Right Arithmetic 


SRA dst,src dstis sk 
SRAB src. IM 
SRAL 

INSTRUCTION FORMAT: (ESeh) 


W/B: mode 110,01 |we dst ate Ogee a 10 R IM 


OPERATION: repeat src times: 
dst(msb) <- dst(msb) 
dst(n) <- dst(ntl) {n is 0 to msb-1} 
Cc <- dst(0) 


The destination operand is shifted arithmetically right 
the number of bit positions specified by the source 
operand. For SRAB, the source is in the range 0 to 8; 

for SRA, the source is in the range 0 to 16; for SRAL, the 
source is in the range 0 to 32. A shift of zero positions 
does not affect the destination, however, the flags are set 
according to the destination value. The sign bit of the 
destination is replicated, and the C flag is loaded from 
bit 0 of the destination. The source operand may be 
omitted from the assembly language statement and thus 
defaults to the value l. 


Byte: po ae 


N=Ol pd phig ceils gd 
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SRA 


Shift Right Arithmetic 


Set if the last bit shifted from the destination 
was 1; cleared otherwise 

Set if the result is zero; cleared otherwise 

Set if the result is negative; cleared otherwise 
Cleared 

Unaffected 

Unaffected 


FLAGS: 


a 


mo<nn 


CYCLES: Word/Byte Long 
P3+3Fn 1343*n (n=number of bit positions, 


where 0 is equivalent to 1) 
NOTE: The "src field" is encoded in the instruction format as 
the 16-bit two's complement negative value of the source 
operand. For each operand size, the operation is undefined 
if the source operand is not in the range specified above. 
EXAMPLE: If register RH6 contains %3B (00111011), the statement 
SRAB RH6,#2 


will leave the value %0E (00001110) in RH6 and set the 
carry flag-~ 
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SRL 


Shift Right Logical 


SRL dst,srce dst: R 
SRLB srics BM 
SRLL 

INSTRUCTION FORMAT: (ES).!) 


we:Pelo =, Te] Bde Sgt stg 
Laas. Cnt 


dst JET | 
sag PP Bertha ately, Glen. SH pe clades 


OPERATION: repeat src times: 
dst(msb) <- 0 
dst(n) <- dst(nt+l) {n is 0 to msb-1} 
Cc <- dst(0) 


The destination operand is shifted logically right the 

number of bit positions specified by the source operand. 
For SRLB, the source operand is in the range 0 to 8; for 
SRL, the source is in the range 0 to 16; for SRLL, the 


source is in the range 0 to 32. A shift of. zero positions 
does not affect the destination, however, the flags are set 
according to the destination value. The most significant 

bit of the destination is filled with 0, and the C flag is 


loaded from bit 0 of the destination. This instruction 
performs an unsigned division of the destination by a 


power of two. The source operand may be omitted from the 
assembly language statement and thus defaults to the value 


of I. 


ae | aR SC 


15 0 


n=0,2,4,...,14 
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SRL 


Shift Right Logical 


FLAGS:. C: Set if the last bit shifted from the destination 
was 1; cleared otherwise 


Z: Set if the result is zero; cleared otherwise 

S: Set if the most significant bit of the result is 
set; cleared otherwise 

V: Undefined 

D: Unaffected 

H: Unaffected 

CYCLES: Word/Byte Long 
Ibsen s hao) 13 +30 (n=number of bit positions, 
where 0 is equivalent to 1) 

NOTE: The "src field" is encoded in the instruction format as 
the 16-bit two's complement negative value of the source 
operand. For each operand size, the operation is undefined 
if the source operand is not in the range specified above. 

EXAMPLE: If register RO contains %1111 (0001000100010001), the 
statement 

SRL R0O,#6 


will leave the value $0044 (0000000001000100) in RO and 
clear the carry flag. 
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SUB 


Subtract 
SUB dst,src dst: R 
SUBB sires uM, rR, DA, & 
SUBL 

INSTRUCTION FORMAT: (B2.1) 


mode dst src 


W/B: 0. 0 0,0 4 10 R 
Ge eh OE | ee) ee gee et ee 
wpe], 1, | «(90 RR (sre fiela<>o) 
Fe Ol R DA (src field=0) 
O01 R X (sre field<>0) 


OPERATION: dst <- dst -— src 


The source operand is subtracted from the destination 
operand and the result is stored in the destination. 
The contents of the source are not affected. Sub- 
traction is performed by adding the two's complement 
of the source operand to the destination operand. 


FLAGS: C: Cleared if there is a carry from the most significant 

bit; set otherwise, indicating a "borrow" 

Z: Set if the result is zero; cleared otherwise 

S: Set if the result is negative; cleared otherwise 

V: Set if arithmetic overflow occurs, that is, if the 
operands were of opposite signs and the sign of the 
result is the same as the sign of the source; cleared 
otherwise 

D: SUB,SUBL - unaffected; SUBB - set 

H: SUB,SUBL - unaffected; SUBB - cleared if there is a 
carry from the most significant bit of the low-order 
four bits of the result; set otherwise, indicating a 


"borrow" 
CYCLES: src Word/Byte Long 
NS? SS) "SL NS SS SL 
R 40s == Shy aa ee 
IM ee ees Bema PAY Ore oie 
IR i A 
DA 9 10 12 15 16 i8 
X LO’ wo 23 16 U6: 29 


EXAMPLE: If register RO contains %0344, the statement 
SUB RO,#%AA 


will leave the value %029A in RO. 
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TCC 


Test Condition Code 


TCE ee,ast dst: RF 
TCCB 
INSTRUCTION FORMAT: (F1.4) 
mode dst 


7 Cd CC 


OPERATION: 


FLAGS: 


CYCLES: 


EXAMPLE: 


“| 


if cc is true then dst(0) <= 1 


This instruction is used to create a Boolean data value 
based on the condition code resulting from a previous 
operation. The condition code specified by NeGu fis 
tested. If the condition is true, then the least 
significant bit of the destination is set; otherwise it 
is unaffected. See section 3.2.1 for a list of condi- 
tion codes. All other bits in the destination are 
unaffected. 


No flags affected 


Word/Byte 


If register Rl contains 0, and the Z flag is set, the 
statement 


TCE EQ, RI 


will leave the value 1 in Rl. 
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TEST 


Test 
TEST dst dst: dRALLR, DA;IX 
TESTB 
TESTL 
INSTRUCTION FORMAT: (F1.1) 
mode dst 
w/ss[meie[o ot eh et letee] 10 OR 


00 TR 
2 eee ae eee 
OPERATION: dst OR 0 


The destination operand is tested (logically ORed with 
zero), and the appropriate flags set accordingly, which 
may then be used for arithmetic and logical conditional 
jumps. The contents of the destination are not affected. 


FLAGS: C: Unaffected 

Z: Set if the result is zero; cleared otherwise 

S: Set if the most significant bit of the result 
is set; cleared otherwise 

P: TEST - unaffected; TESTL - undefined; 
TESTB - set if parity of the result is even; 
cleared otherwise 

D: Unaffected 

H: Unaffected 


CYCLES: dst Word/Byte Long 
NS SS SL NS *SS” SL 
R Jo-- -- 13 -- -- 
IR 8 -- -- 3 = = 
DA Tt -i2 “14 l6- 17? As 
D4 iE2e a2 Ss. Wy Ane 20 
EXAMPLE: If register R5 contains $FFFF (1111111111111111), 


the statement 
TEST R5 


will set the S flag, clear the Z flag, and leave 
the other flags unaffected. 
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TRDB 


Translate and Decrement 


——— —————— 


INSTRUCTION FORMAT: 


OPERATION: 


FLAGS: C: 
“as 
Ss 
V: 
De 
ne 

CYCLES: 


TRDB dst,src,r dst: IR 
sroo TR 

(F6.4) 
st’ “‘srie 


dst <- src[dst] 
AUTODECREMENT dst {-1} 


r <p 

This instruction is used to translate a string of 
bytes from one code to another code. The contents 
of the location addressed by the destination reg- 
ister (the "target byte") is used as an index into 
a table of translation values whose lowest address 
is contained in the source register. The index is 
computed by adding the target byte to the address 
contained in the source register. The addition is 
performed following the rules for addressing mode 
arithmetic, with the target byte treated as an un- 
signed 8-bit value extended with high-order zeros. 
The sum is used as the address of an 8-bit transla- 
tion value within the table which replaces the 
original contents of the location addressed by the 
destination register. 


The destination register is then decremented by one, 
thus moving the the pointer to the previous element in 
the string. The word register specified by "r" (used 
as a counter) is then decremented by one. 


Because the 8-bit target byte is added to the source 
register to obtain the address of a translation value, 
the table may contain 256 bytes. A smaller table size 
may be used where it is known that not all possible 
8-bit target byte values will occur. 


Unaffected 
Undefined 

Unaffected 
Set if the 
otherwise 

Unaffected 
Unaffected 


ae 


result of decrementing r is zero; cleared 
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TRDB 


Translate and Decrement 


NOTE: 


EXAMPLE: 
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The original contents of register RH1 is lost, and is 
replaced by an undefined value. 


If register R6 contains %4001, the byte at location 
$4001 contains 3, register R9 contains %1000, the 
byte at location %1003 contains %AA, and register R12 
contains 2, the statement 


TRDB @R6,@R9,R12 


will leave the value %AA in location %4001, the value 
$4000 in R6, and the value 1 in R12. R9 will not be 
affected. 


TRDRB 


Translate, Decrement and Repeat 


INSTRUCTION FORMAT: 


TRDRB dst,src,r dst: IR 
snes IR 
(F6.4) 
dst y°SHeo sr 
IR IR R 


Bs 
OPERATION: 
FLAGS: cs 

Z3 
S: 
Viz 
Dic 
H: 


dst <= 


src[dst] 
AUTODECREMENT dst {-l} 
i itaunes DL 

repeat until r = 0 


This instruction is used to translate a string of bytes 
from one code to another code. The contents of the 
location addressed by the destination register (the 
"target byte") is used as an index into a table of 
translation values whose lowest address is contained 

in the source register. The index is computed by 
adding the target byte to the address contained in the 
source register. The addition is performed following 
the rules for addressing mode arithmetic, with the 
target byte treated as an unsigned 8-bit value extended 
with high-order zeros. The sum is used as the address 
of an 8-bit translation value within the table which 
replaces the original contents of the location address- 
ed by the destination register. 


The destination register is then decremented by one, 
thus moving the pointer to the previous element in the 
string. The word register specified by "r" (used as a 
counter) is then decremented by one. The entire 
operation is repeated until the result of decrementing 
r is zero. This instruction can translate from 1 to 
65536 bytes. 


Because the 8-bit target byte is added to the source 
register to obtain the address of a translation value, 
the table may contain 256 bytes. A smaller table size 
may be used where it is known that not all possible 
8-bit target byte values will occur. 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 
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TRDRB 


Translate, Decrement and Repeat 


CYCLES; 


NOTES: 


EXAMPLE: 
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Byte 
11+14*n (n=number of data elements translated) 


The original contents of register RH1 is lost, and is 
replaced by an undefined value. 


This instruction can be interrupted after each 
execution of the basic operation. The program 
counter of the start of this instruction is saved 
before the interrupt request is accepted, so that 
the instruction can be properly resumed. Seven 
more cycles should be added to this instruction's 
execution time for each interrupt request that is 
accepted. 


If register R6 contains %4002, the bytes at locations 
$4000 through %4002 contain the values %00, %40, %80, 
respectively, register R9 contains $1000, the trans- 
lation table from location %1000 through $10FF con- 
tains 90 pli,;2 poe. SIF 0,127. (o787F (the ‘Second zero 
is located at %1080), and register R12 contains 3, 
the statement 

TRDRB @R6,@R9,R12 
will leave the values $00, %40, %00 in locations %4000 
through %4002, respectively. Register R6 will contain 
$3FFF, and R12 will contain 0. R9 will not be affected. 


BEFORE 
% 1000 


%4000 }O00000000 % 1001 
%4001 }01000000 %1002 
%4002 }10000000 e 


AFTER %AOTF 
% 1080 


%4000 }O0000000 % 1081 
%4001 }01000000 %o 1082 
%4002 }00000000 ° 


% OFF 


TRIB 


Translate and Increment 


INSTRUCTION FORMAT: 


OPERATION: 


TRIB dst,src,r dst: IR 
sreswdR 
(F6.4) 
dstersre i 
IR IR R 


dst <- src[dst] 
AUTOINCREMENT dst {+1} 
r -¢=strsS it 


This instruction is used to translate a string of bytes 
from one code to another code. The contents of the 
location addressed by the destination register (the 
"target byte") is used as an index into a table of 
translation values whose lowest address is contained 
in the source register. The index is computed by 
adding the target byte to the address contained in the 
source register. The addition is performed follow- 
ing the rules for addressing mode arithmetic, with 

the target byte treated as an unsigned 8-bit value 
extended with high-order zeros. The sum is used as 
the address of an 8-bit translation value within 

the table which replaces the original contents of 

the location addressed by the destination register. 


The destination register is then incremented by one, 
thus moving the pointer to the next element in the 
string. The word register specified by "r" (used 

as a counter) is then decremented by one. 


Because the 8-bit target byte is added to the source 
register to obtain the address of a translation value, 
the table may contain 256 bytes. A smaller table 


‘ size may be used where it is known that not all pos- 


FLAGS: 


CYCLES: 


sible 8-bit target byte values will occur. 


Unaffected 

Undefined 

Unaffected 

Set if the result of decrementing r is zero; 
otherwise 

Unaffected 

Unaffected 


— 


cleared 
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TRIB 


Translate and Increment 


NOTE: The original contents of 
replaced by an undefined 
EXAMPLE: This instruction is used 
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which translate a string 


register RH1 is lost, and is 


value. 


in a “loop" of instructions 
of data from one code to 


any other desired 


ation on each data element is required. 


code, but an intermediate oper- 
The follow- 


ing sequence translates a string of 1000 bytes to the 
same string of bytes, with all ASCII "control char- 


acters" (values less than 32, see Appendix) translat- 
ed to the "blank" character (value=32). A test, how- 
ever, is made for the special character "return" 


(value=13) which terminates the loop. 
table contains 256 bytes. 
all contain the value 32, 


The translation 
The first 33 (0-32) entries 
and all other entries con- 


tain their own index in the table, counting from 


zero. 

LD R3,#1000 
LD R1,#STRING 
LD R2,#TABLE 
CPB @R1,#13 
IR EQ,DONE 
TRIB @R1,@R2,R3 
JR NOV, LOOP 


TABLE +0 
TABLE +1 
TABLE +2 


TABLE + 32 
TABLE + 33 
TABLE + 34 


TABLE + 255 


00100000 
00100000 
00100000 


00100000 
00100001 
00100010 


{Initialize counter! 
!Load start addresses! 


!Check for return character! 
!Exit loop if found! 
!Translate next byte! 


!Repeat until counter 0! 


TRIRB 


Translate, Increment and Repeat 


INSTRUCTION FORMAT: 


OPERATION: 
FLAGS: 
CYCLES: 


TRERB dst ,sre;r dst: IR 
sre oLR 
(F6.4) 
Sit 2 cSHG, i 4F 
IR IR R 


dst <= 


src[dst] 
AUTOINCREMENT dst {+1} 


ro <S-e e 
repeat until r = 0 


This instruction is used to translate a string of bytes 
from one code to another code. The contents of the 
location addressed by the destination register (the 
"target byte") is used as an index into a table of trans- 
lation values whose lowest address is contained in the 
source register. The index is computed by adding the 
target byte to the address contained in the source 
register. The addition is performed following the rules 
for addressing mode arithmetic, with the target »yte 
treated as an unsigned 8-bit value extended with high- 
order zeros. The sum is used as the address of an 8-bit 
translation value within the table which replaces the 
original contents of the location addressed by the dest- 
ination register. 


The destination register is then incremented by one, thus 
moving the pointer to the next element in the string. 

The word register specified by "r" (used as a counter) is 
then decremented by one. The entire operation is repeated 
until the result of decrementing r is zero. This in- 
struction can translate from 1 to 65536 bytes. 


Because the 8-bit target byte is added to the source 
register to obtain the address of a translation value, 
the table may contain 256 bytes. A smaller table size 
may be used where it is known that not all possible 8-bit 
target byte values will occur. 


Unaffected 
Undefined 
Unaffected 
Set 
Unaffected 
Unaffected 


Byte 
11+14*n (n=number of data elements translated) 
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TRIRB 


Translate, Increment and Repeat 


NOTES: 


EXAMPLE: 
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The original contents of register RH1 is lost, and is 
replaced by an undefined value. 


This instruction can be interrupted after each exe- 
cution of the basic operation. The program counter 
of the start of this instruction is saved before 

the interrupt request is accepted, so that the in- 
struction can be properly resumed. Seven more cycles 
should be added to this instruction's execution time 
for each interrupt request that is accepted. 


The following sequence of instructions can be used to 
translate a string of 80 bytes from one code to an- 
other. The pointers to the string and the trans- 
lation table are set, the number of bytes to translate 
is set, and then the translation is accomplished. 


LD R1,#STRING 
LD R2,#TABLE 
LD R3, #80 
TRIRB @R1,@R2,R3 


TRIDB 


Translate, Test and Decrement 


TRIDB sicl.,.sre2,¥r srel s OER 
Ssre2: 9ER 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 


n 
Q 
i) 


srel as 
IR 


tH 
cs) 
bol 


RH1 <- src2[srcl] 
AUTODECREMENT srcl {-1l} 
r<-r-l 


This instruction is used to scan a string of bytes 
testing for bytes with special meaning. - The contents 

of the location addressed by the first source register 
(the "target byte") is used as an index into a table 

of translation values whose lowest address is con- 
tained in the second source register. The index is 
computed by adding the target byte to the address con- 
tained in the second source register. The addition is 
performed following the, rules for addressing mode arith- 
metic, with the target byte treated as an unsigned 8-bit 
value extended with high-order zeros. The sum is used 
as the address of an 8-bit value within the table which 
is loaded into register RH1. The Z flag is set if the 
value loaded into RH1 is zero; otherwise the Z flag is 
cleared. The contents of the locations addressed by the 
source registers are not affected. 


The first source register is then decremented by one, 
thus moving the pointer to the previous element in the 
string. The word register specified by "r" (used as a 
counter) is then decremented by one. 


Target byte values which have corresponding zero trans- 
lation table entry values are to be scanned over, while 
target byte values which have corresponding non-zero 
translation table entry values are to be detected. 
Because the 8-bit target byte is added to the second 
source register to obtain the address of a translation 
value, the table may contain 256 bytes. A smaller table 
size may be used where it is known that not all possible 
8-bit target byte values will occur. 
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TRTDB 


Translate, Test and Decrement 


FLAGS: Unaffected 

Set if the translation value loaded into RH1 is zero; 
cleared otherwise 

Unaffected 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


CYCLES: Byte 


NO 


qn 


mo 


EXAMPLE: If register R6 contains %4001, the byte at location 
$4001 contains 3, register R9 contains %1000, the 
byte at location %1003 contains %AA, and register 
R12 contains 2, the statement 


TRTDB @R6,@R9,R12 
will leave the value %$AA in RH1, the value %4000 in 


R6, and the value 1 in R12. Location %4001 and 
register R9 will not be affected. 
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TRTDRB 


Translate, Test, Decrement and Repeat 


TRIDRB srel ,jsre2,r Srcl:, IR 
SreziaiR 


INSTRUCTION FORMAT: (F6.4) 


Sel 6 Sne2 
ER IR 


co 


OPERATION: 


RH1 <- src2[srcl] 
AUTODECREMENT srcl {-1} 

LoS XL} seek 

repeat until RAL <> 0 or © = 0 


This instruction is used to scan a string of bytes 
testing for bytes with special meaning. The contents 
of the location addressed by the first source register 
(the "target byte") is used as an index into a table 

of translation values whose lowest address is contained 
in the second source register. The index is computed 
by adding the target byte to the address contained in 
the second source register. The addition is performed 
following the rules for addressing mode arithmetic, 
with the target byte treated as an unsigned 8-bit 

value extended with high-order zeros. The sum is used 
as the address of an 8-bit value within the table which 
is loaded into register RHl1. The Z flag is set if the 
value loaded into RH] is zero; otherwise the 2 flag is 
cleared. The contents of the locations addressed by 
the source registers are not affected. 


The first source register is then decremented by one, 
thus moving the pointer to the previous element in the 
string. The word register specified by "r" (used as 

a counter) is then decremented by one. The entire 
operation is repeated until either the Z flag is clear, 
indicating that a non-zero translation value was loaded 
into RH1, or until the result of decrementing r is 
zero. This instruction can translate and test from 1 
to 65536 bytes. 


Target byte values which have corresponding zero 
translation table entry values are to be scanned 
over, while target byte values which have correspond- 
ing non-zero translation table entry values are to be 
detected. Because the 8-bit target byte is added to 
the second source register to obtain the address of a 
translation value, the table may contain 256 bytes. 

A smaller table size may be used where it is known 
that not all possible 8-bit target byte values will 
occur. 
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TRTDRB 


Translate, Test, Decrement and Repeat 


FLAGS: 


NQ 


ro <n 


CYCLES: 


NOTE: 


EXAMPLE: 
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Unaffected 

Set if the translation value loaded into RH1 is zero; 
cleared otherwise 

Unaffected 

Set if the result of decrementing r is zero; 
otherwise 

Unaffected 

Unaffected 


cleared 


Byte 


11+14*n (n=number of data elements tested) 

This instruction can be interrupted after each exe- 
cution of the basic operation. The program counter of 
the start of this instruction is saved before the in- 
terrupt request is accepted, so that the instruction 
can be properly resumed. Seven more cycles should be 
added to this instruction's execution time for each 
interrupt request that is accepted. 


If register R6 contains %4002, the bytes at locations 
$4000 through %4002 contain the values %00, 240, %80, 
respectively, register R9 contains %1000, the transla- 
tion table from location $1000 through $10FF contains 
O72) 255 (STP PO PY, 2/5 2,87F (the "siecondilizero is 
located at %1080), and register R12 contains 3, the 
statement 


TRTDRB @R6,@R9,R12 


will leave the value %40 in RH1 (which was loaded from 
location %1040). Register R6 will contain %4000, and 
R12 will contain 1. R9 will not be affected. 


% 1000 


%4000 }00000000 % 1001 
%4001 |01000000 % 1002" 
%4002 }10000000 e 


%107F 
% 1080 
% 1081 
%1082 


% OFF 


TRTIB 


Translate, Test and Increment 


TRITB sre, isre2,r Srelkis arm: 
src2e¢iR 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 


srcelon srco2 1x 
IR IR R 


RH1 <- src2[srcl] 
AUTOINCREMENT srcl {+1} 
r <= rsa 


This instruction is used to scan a string of bytes 
testing for bytes with special meaning. The contents 
of the location addressed by the first source register 
(the "target byte") is used as an index into a table 
of translation values whose lowest address is con- 
tained in the second source register. The index is 
computed by adding the target byte to the address 
contained in the second source register. The addi- 
tion is performed following the rules for addressing 
mode arithmetic, with the target byte treated as an 
unsigned 8-bit value extended with high-order zeros. 
The sum is used as the address of an 8-bit value 
within the table which is loaded into register RHl. 
The Z flag is set if the value loaded into RH1 is 
zero; otherwise the Z flag is cleared. The contents 
of the locations addressed by the source registers 
are not affected. 


The first source register is then incremented by one, 
thus moving the pointer to the next element in the 
string. The word register specified by "r" (used as 
a counter) is then decremented by one. 


Target byte values which have corresponding zero 
translation table entry values are to be scanned 
over, while target byte values which have corres- 
ponding non-zero translation table entry values are 
to be detected. Because the 8-bit target byte is 
added to the second source register to obtain the 
address of a translation value, the table may con- 
tain 256 bytes. A smaller table size may be used 
where it is known that not all possible 8-bit target 
byte values will occur. 
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TRTIB 


Translate, Test and Increment 


FLAGS: C: 
Zs 
Ss 
Vs 
D: 
He 

CYCLES: 

EXAMPLE: 
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Unaffected 

Set if the translation value loaded into RH1 is zero; 
cleared otherwise 

Unaffected 

Set if the result of decrementing r is zero; 
otherwise 

Unaffected 

Unaffected 


Byts 


This instruction is used in a "loop" of instructions 
which translate and test a string of data, but an 
intermediate operation on each data element is re- 
quired. The following sequence outputs a string of 
72 bytes, with each byte of the original string 
translated from its 7-bit ASCII code (see Appendix) 
to an 8-bit value with odd parity. A test, however, 
is made for the special character "return" (value=%D) 
which terminates the loop. The translation table 
contains 128 bytes, which assumes that the most 
significant bit of each byte in the string is always 
zero. Each entry contains its own index in the 
table in the low-order seven bits, with the most 
significant bit of the value set or cleared to 

give odd parity for the entire value. 


cleared 


LD R4,#72 !Initialize counter! 

LD R5,#STRING !Load start addresses! 

LD R6,#TABLE 
LOOP: 

CPB @R5,#%D !Check for return character! 

JR EQ,DONE !Exit loop if found! 

TRTIB @R5,@R6,R4 !Translate next byte! 

OUTB PORTN,RH1 !Output with odd parity! 

JR NOV, LOOP !Repeat until counter=0! 
DONE: 


TABLE +0 
TABLE +1 
TABLE +2 
TABLE +3 
TABLE +4 
TABLE+5 
TABLE +6 
TABLE +7 
TABLE+8 
TABLE +9 


- 


TRIIRB 


Translate, Test, Increment and Repeat 


TRITRB srcl,sre2,r srcl ss ER 
Snes. -LR 


INSTRUCTION FORMAT: (F6.4) 


OPERATION: 


srel asre2) x 
IR IR R 


RH1 <- src2[srcl] 
AUTOINCREMENT srcl {+l} 
r<-r-l 

repeat until RHI <> 0 of r = 9 


This instruction is used to scan a string of bytes 
testing for bytes with special meaning. The contents 
of the location addressed by the first source register 
(the "target byte") is used as an index into a table 
of translation values whose lowest address is contain- 
ed in the second source register. The index is com- 
puted by adding the target byte to the address con- 
tained in the second source register. The addition is 
performed following the rules for addressing mode 
arithmetic, with the target byte treated as an unsigned 
8-bit value extended with high-order zeros. The sum 
is used as the address of an 8-bit value within the 
table which is loaded into register RH1. The Z flag 
is set if the value loaded into RH1 is zero; otherwise 
the Z flag is cleared. The contents of the locations 
addressed by the source registers are not affected. 


The first source register is then incremented by one, 
thus moving the pointer to the next element in the 
string. The word register specified by "r" (used as 

a counter) is then decremented by one. The entire 
operation is repeated until either the Z flag is 

clear, indicating that a non-zero translation value 

was loaded into RH1, or until the result of decrement- 
ing r is zero. This instruction can translate and test 
from 1 to 65536 bytes. 


Target byte values which have corresponding zero 
translation table entry values are to be scanned over, 
while target byte values which have corresponding 
non-zero translation table entry values are to be 
detected. Because the 8-bit target byte is added to 
the second source register to obtain the address of 

a translation value, the table may contain 256 bytes. 
A smaller table size may be used where it is known 
that not all possible 8-bit target byte values will 
occur. 
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TRTIRB 


Translate, Test, Increment and Repeat 


FLAGS: C: 
Zs 
Sie 
Vig 
De 
He 
CYCLES: 
NOTE: 
EXAMPLE: 
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Unaffected 

Set if the translation value loaded into RH1 is zero; 
cleared otherwise 

Unaffected 

Set if the result of decrementing r is zero; cleared 
otherwise 

Unaffected 

Unaffected 


By te 


11+14*n (n=number of data elements tested) 


This instruction can be interrupted after each execution 
of the basic operation. The program counter of the 
start of this instruction is saved before the interrupt 
request is accepted, so that the instruction can be 
Properly resumed. Seven more cycles should be added 

to this instruction's execution time for each interrupt 
request that is accepted. 


The following sequence of instructions can be used to 
scan a string of 80 bytes, testing for special char- 
acters as defined by corresponding non-zero translation 
table entry values. The pointers to the string and 
translation table are set, the number of bytes to scan 
is set, and then the translation and testing is 
accomplished. The Z and V flags can be tested after 
the operation to determine if a special character was 
found, and whether the end of the string has been 
reached. The translation value loaded into RH1 might 
then be used to index another table, or to select one 
of a set of sequences of instructions to execute next. 


LD R4,#STRING 
LD R5,#TABLE 
LD R6,#80 

TRTIRB @R4,@R5,R6 
IR NZ ,SPECIAL 


END_OF_STRING: F 


° 


SPECIAL: 
JR OV,LAST_CHAR_ SPECIAL 


LAST CHAR SPECIAL: 


TSET 


Test and Set 


TSET dst dst: °R,' IR, DA, X 
TSETB 


INSTRUCTION FORMAT: (BL...) 
mode dst 


ws: Peele] Ft] 10 CR 


00 IR 
01 DA (dst field=0) 
01 X (dst field<>0) 


OPERATION: S <- dst(msb) 
dst(O:msb) <- 111...111 


Tests the most significant bit of the destination 


operand, copying its value into the S flag, then sets the 
entire destination to all 1 bits. This instruction pro- 
vides a locking mechanism which can be used to synchro- 

nize software "processes" which require exclusive access 


to certain data or instructions at one time. 


FLAGS: C: Unaffected 
Z: Unaffected 
S: Set if the most significant bit of the destination 
was 1; cleared otherwise 
V: Unaffected 
D: Unaffected 
H: Unaffected 


CYCLES: dst Word/Byte 
NS SS SL 
R Jo--- -- 
ER LL == == 
DA PAS As. ey 
xX 15 25 28 
NOTE: During the execution of this instruction, BUSRQ is not 


honored in the time between loading the destination 
from memory and storing the destination to memory. 
For systems with one processor, this ensures that the 


testing and setting of the destination will be completed 


without any intervening accesses. This instruction 


should not be used to synchronize software "processes" 


residing on separate processors where the destination 


is a shared memory location, since this locking mechanism 


cannot be guaranteed to function correctly with 
multi-processor accesses. 
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TSET 


Test and Set 


EXAMPLE: A simple mutually-exclusive "critical region" may be 
implemented by the following sequence of statements: 


ENTER: 

TSET SEMAPHORE 

JR MI,ENTER !loop until resource 
controlled by SEMAPHORE 


is available! 


!Critical Region--only one software process 
executes this code at a time! 


CLR SEMAPHORE !release resource con- 
trolled by SEMAPHORE! 
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XOR 


Exclusive OR 


XOR dst,srcec dst: R 
XORB sree Rife EMER! IDA, xX 


INSTRUCTION FORMAT: (B26 0) 
' mode dst src 


W/B: 0 0 1 0 oO |wB TOT R wer 

ied Ce ee oe ee Ee eee 
00 R IR (sre field<>0) 
Ol R DA (src field=0) 
Ol R X (sre field<>0) 


OPERATION: dst <- dst XOR sre 


The source operand is logically EXCLUSIVE ORed with the 
destination operand and the result is stored in the 
destination. The contents of the source are not affected. 
The EXCLUSIVE OR operation results in a one bit being 
stored whenever the corresponding bits in the two 
operands are different; otherwise, a zero bit is stored. 
FLAGS: C: Unaffected 
Z: Set if the result is zero; cleared otherwise 
S: Set if the most significant bit of the result 
is set; cleared otherwise 
P: XOR - unaffected; XORB - set if parity of the 
result is even; cleared otherwise 
D: Unaffected 
H: Unaffected 


CYCLES: src Word/Byte 


NS SS SL 
R 4 -- -- 
IM . = = 
IR To-- -- 
DA 9. 10» 12 
xX £0), wor eats 
EXAMPLE: If register RL3 contains %$C3 (11000011) and the source 
operand is the immediate value %7B (01111011), the 
statement 


XORB- RL3,#%7B 


will leave the value $B8 (10111000) in RL3. 
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3.4 UNIMPLEMENTED INSTRUCTIONS 


As explained in Section 1.6.4, certain binary instruction codes 
are defined by the 28000 architecture, but are not currently 
implemented by the hardware. The following opcodes (listed by 
the first instruction word in hexadecimal where "x" means any 
value) will cause an Unimplemented Instruction trap if an 
attempt is made to execute them: 


OExx 
OFxx 
4Exx 
4Fxx 
8Exx 
8Fxx 


NOTE 


These opcodes are reserved for future 
extensions to the Z8000 architecture and must 
not be used by the programmer. To provide 
for compatibility with Zilog hardware and 
software systems, the results of attempted 
execution of these instructions is undefined, 
other than the occurrence of an Unimplemented 
Instruction trap. 
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Section 4 
Structuring a Z8000 Program 


4.1 INTRODUCTION 


This section introduces the high-level PLZ/ASM statements 
described in Section 5. The structuring of programs and _ the 
concepts of module linkage and relocation are discussed. 


4.2 PROGRAM STRUCTURE 


4.2.1 Modules 


A 28000 PLZ/ASM program consists of one or more separately-coded 
and assembled modules. These modules are combined into an 
executable program using the module linkage end relocation 
facilities of an operating system such as 2-80 RIO. One of the 
modules should include a "main program"; that is, a GLOBAL 
procedure whose name is supplied to the linking facility as the 
program's entry point. 


PLZ/ASM modules are made up of high-level and assembly-language 
statements that either declare or define data or perform some 
action. The assembly-language statements described in Section 3 
are action statements. In general, data definition equates an 
identifier with a fixed value or type, whereas data declaration 
equates an identifier with a variable and associates a type with 
eg 


Data, labels, or procedures can be shared between modules by 
declaring them to be GLOBAL in one module and Geclaring them as 
EXTERNAL in other modules that reference them. Data, labels, or 
procedures declared as INTERNAL to a module may be referenced 
only within that module. See Section 4.2.5 for more explanation 
of the scope of these objects. 


The following example is the skeleton of a module showing two 
procedures, the second of which is a main program. 
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bubble sort MODULE 


CONSTANT 
false := 0 'Constant definition! 
true atl 
EXTERNAL 
list ARRAY [10 WORD] !External variable 
declared in another module 
INTERNAL !First procedure! 
sort !Procedure name! 
PROCEDURE 
END sort !End first procedure! 
GLOBAL !Second procedure! 
main 
PROCEDURE 
ENTRY 
LD RO, #9*2 
CALL sort 
RET 
END main !End second procedure! 
END bubble sort !End of module! 


4.2.2 Procedures 


A procedure declaration defines an executable portion of a module 
(including both action and data statements). It also associates 
an identifier with that block of code so that it can be activated 
by the assembly-language CALL statement. (See the “CALL sort” 
statement in the preceding example). 


Every procedure declaration also has a scope associated with it. 
It can be: 


e GLOBAL (the procedure can be called from other 
modules); 


e INTERNAL (it can be called only within the 
current module); 


e EXTERNAL (it is called from the current module, 
but is declared as GLOBAL in another module). 
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A procedure declaration can include LOCAL variables or label 
declarations as shown in the following example. LOCAL variables 
and labels can be referenced only within the procedure in which 
they are declared. 


INTERNAL !Procedure scope! 
sort !Procedure name! 
PROCEDURE 
LOCAL 
switch BYTE !Local variable! 
ENTRY 
DO !DO loop introduced! 


j !(action statements) ! 


OD !End DO loop! 
END sort !End of procedure! 


Note in this example that the keyword ENTRY is used to separate 
the declarations of LOCAL variables from the executable action 
statements making up the body of the procedure. The example also 
carries the previous “bubble-sort module" example to the first 
inner level of detail--the procedure. At the same time it 
introduces another program structuring element--the DO loop. 


4.2.3 DO Loops 


The description of the DJNZ instruction in Section 3 pointed out 
that it is used primarily for loop control. DO loops perform a 
Similar function, but in a more structured, high-level manner. 
The statements between the keywords DO and OD are _ executed 
repeatedly until control is diverted through a loop control 
statement: REPEAT, EXIT, or one of the assembly-language branch 
statements. The EXIT statement causes execution to continue at 
the first statement following the innermost DO loop’ containing 
the EXIT, while REPEAT statement causes execution to continue at 
the first statement of the innermost DO loop containing the 
REPEAT. 


A DO statement does not introduce a new scope. It contains only 
action statements. 
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The following example enlarges upon the original "bubblesort" 
skeleton and also introduces the IF statement. 


DO 
LDB switch, #false 
CLR RE 
DO !Note nested DO loop! 
ce’ Ri Ro 
IF UGE THEN EXIT FI !IF statement at inner level! 
ING “RI #2 
OD !End nested DO loop! 
CPB switch, #false 
Ts ee tae !IF statement at outer level! 
OD !End DO loop! 


Note in this example that DO loops can contain IF statements or 
other DO loops. IF statements can also have DO loops or other IF 
statements nested within them. 

4.2.4 IF Statements 


The general form of the IF statement is: 


IF condition-code THEN actionl 
ELSE action2 


FI 
The IF statement specifies that all statements between THEN and 
ELSE (actionl) be executed if the condition specified is true. 
Otherwise, the statements between ELSE and FI (action2) are 
executed. The ELSE clause can be omitted, in which case no 
action is performed when the specified condition is false. Like 
the DO loop, the IF statement contains only executable 
statements. 


The condition codes specified are the same as for the assembly 
language JP and JR instructions (section 3.2.1). As in the case 
Of DO loops versus the DJNZ instruction, one can set up 
conditional statements using only assembly-language instructions, 
but the high-level IF statement may lead to a more structured 
program. 
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The following example shows a brief IF statement followed by a 
longer one. 


LP! 7 UGESy ‘BHEN 4 se xen Ts s (EL 


IF UGT THEN 
LDB switch, #true 
LD list(R1l), R6 
LD list(R2), R4 
FI 


4.2.5 Scope 


The ,scopeiyrof a Asvariablei; ;clabel, jor procedure, refers to that 
portion of the program in which the object is recognized and 


handled in keeping with its declaration. When declaring an 
object for use solely within the current module or procedure, its 
use elsewhere is of no concern. Even though the same identifier 


is used in another scope, it refers to a different object. 


In general, a scope can be an entire executable program, a 
module, or a procedure. An identifier is accessible in a scope S 
if it is either 


e Declared in S or in the module containing 
Sip Ob 


e Declared EXTERNAL in the module containing S. 


New identifiers are declared by their appearance in a _ variable, 
procedure, constant, or type declaration, or by their use as a 
label within the module. If a label identifier is not declared 
explicitly, it is assumed to have an INTERNAL scope and thus is 
accessible throughout the module in which it is defined. The 
scope of a label identifier may explicitly be declared to be 
either GLOBAL, INTERNAL, or LOCAL. In addition, a special form 
of statement labels is discussed in Section 5.3.5, which always 
have a LOCAL scope and therefore cannot be declared explicitly. 


New identifiers introduced in a variable, procedure, or label 
declaration are accessible only within the newly-established 
scope as determined from the declaration class specified: 
GLOBAL, EXTERNAL, INTERNAL or LOCAL. A new identifier cannot be 
the same as an identifier already accessible in the current 
scope. 
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For variable and label declarations, GLOBAL specifies that the 
variable is declared in the current module but may be used in 
other modules. GLOBAL variables have a scope of the entire 
executable program. EXTERNAL specifies that the variable is used 
in the current module but declared as GLOBAL in another module. 
INTERNAL specifies that the variable is declared in the current 


module and is accessible only within the current module. _ LOCAL 
specifies that the variable can be accessed only inside the 
Procedure in which it is declared. GLOBAL, EXTERNAL, and 


INTERNAL can only be specified at the module level; LOCAL can 
only be used at the procedure level. 


For variables declared with type RECORD, the scope of a _ record 
field is the module or procedure in which it is defined. Note 
that this implies that record fields must have names that are 
unique within their scope. 


Procedure declarations must be either GLOBAL, EXTERNAL, or 
INTERNAL, as defined for variables above. The name given to the 
procedure as part of the procedure declaration is recognized in 
the entire scope of the enclosing module. 


Constant identifiers are defined using the CONSTANT class, and 
can be defined only at the module level. The scope of a constant 
identifier is the module scope, and it cannot be used outside the 
module unless it is redefined. 


Type identifiers are defined using the TYPE class. They can be 
defined only at the module level and are recognized only within 
the scope of the module. 


An identifier used in a scope and not declared in that scope is 
said to be free in that scope. Any identifier that is free in 
the scope of a procedure must be declared in the enclosing 
module. Procedures do not explicitly import variables into their 
scope as modules do (via the EXTERNAL declaration). 


4.2.6 Summary 


The preceding sections were intended only as an introduction to 
program structuring. The detailed formats of the declarations 
used to define the program structure are listed in Section 5. 
Even without those details, however, the following module should 
be comprehensible at this point. If any statement looks foreign, 
reread the part of Section 3 or 4 that explains its operation. 
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An example of a complete bubble sort module for sorting a 10-word 


array is as follows: 


bubble sort MODULE 


CONSTANT 
false 


EXTERNAL 
list ARRAY [10 WORD] 


INTERNAL 
sort 
PROCEDURE 
LOCAL 
switch BYTE 
ENTRY 
DO 
LDB switch, #false 
CLR RI1 
DO 
GPre Rist RO 
IF UGE THEN EXIT FI 
LD {R22 ! Ri 
INC R2, #2 
LD R4, list(R1) 
LDic RE, Liste: (RZ) 
CP’. R4,: R6 
IF UGT THEN 
LDB switch, #true 
LD Lliste(R.)., R6 
LD list(R2), R4 
FI 
ING URL ph2 


OD 
CPB switch, #false 
[IF EQ THEN -RE® FI 
OD 
END sort 


GLOBAL 
main 
PROCEDURE 
ENTRY 
LD RO, #9*2 


CALL sort 
RET 
END main 


END bubble sort 


!Module declaration! 


{Constant declarations! 


!Procedure declaration! 


!Local variable declaration! 
!Loop control switch! 
!Begin executable part! 


!Initialize switch! 
!Clear array pointer i! 


!Done?! 


!Initialize pointer j! 
!j = itl (double for words)! 


lLf, bbst [ai] >, List [9]. -then! 
!exchange to bubble largest! 
!Inumber to top of array! 


'Advance pointer (double for 
words) ! 

!End nested DO loop! 

!Test switch! 


!End outer DO loop! 
!End of procedure! 


!New procedure declaration! 
!Program entry procedure! 


!No LOCALs! 

!Initialize loop control! 
!Double for word array! 
!Call sort procedure! 
!End of main procedure! 


!End of module! 
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4.3  RELOCATABILITY 


The 28000 PLZ/ASM assembler produces relocatable object modules. 
Essentially, this frees the programmer from memory Management 
concerns during program development (since object code can_ be 
relocated in memory) and also allows programs to be developed in 
modules whose addresses are resolved automatically when the 
modules. are linked. 


Modular program development offers numerous advantages to the 
developer. Complex programs can be divided into several smaller 
tasks and assigned to a development team, should schedule 
constraints require quick completion. An entire program need not 
be delayed while one module is awaiting development, since 
modules can be separately tested and assembled. A change 
affecting a single module will not have a ripple effect through 
the entire program and will require reassembly of the affected 
module only. In short, several simple programs are generally 
easier to write, test, and debug than one large, complex program. 


The relocatability feature of the 28000 assembier is supported by 
the SABS, SREL, and SSECTION assembler directives. These 
directives determine whether programs are assembled in 
relocatable mode or not, and where data and action statements are 
to be loaded into memory. An operating system program called a 


linker relocates object modules and resolves’ inter-module 
references. 
These assembler directives are summarized below. Other 


directives are listed in Appendix C, and are described in detail 
in the Z8000 Assembler User's Guide. 


4.3.1 Sections 


In addition to the logical structuring provided by modules and 
procedures, it is possible to divide a program into sections 
which can be mapped into various ereas of memory when the program 
is linked or loaded for execution. For example, the programmer 
may choose to group a4 set of data structures and the procedures 
which manipulate them together in the same module. BUtVlLt: may 
also be desirable to physically separate the object code for the 
procedures from the data in a system where read-only memory is 
used for the procedures and read/write memory is used for the 
data. 


The assembler allows a program to be arbitrarily divided into 
named sections. Each section might be allocated to a different 
address space; for instance, code or date memory. In the 
segmented 28000, each section might be mapped into a different 
segment, or several sections might be combined from different 
modules into the same segment. A single module may contain 
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several sections, each of which will be allocated a different 
area in memory. Alternatively, the portions of a single section 
May be spread through several modules and the portions will be 
automatically combined into a single area by the linker. 
Sections provide the programmer with complete control over the 
mapping of a program into the address spaces of the 28000 
processor. 


Usually the full generality of arbitrary sections is not needed 
for a particular application. By default, the assembler 
automatically creates two sections for each module, one for all 
the data variables and the other for all procedures. The data 
section is given the same name as the module name, with the 


suffix "_D™ (or "“_d") appended. The procedure section is given 
the same name as the module name, with the suffix "_P" (or "_p") 
appended. If the first character of the module name is 


uppercase, then an uppercase suffix is used; otherwise, a 
lowercase suffix is used. 


For example, the data section "bubble sort _d" will be created for 
the sample module in Section 4.2.6, and contains only the BYTE 
named "switch". The program section "bubble sort_p" contains all 
the code in the module. 


The SSECTION assembler directive can be used to override the 


default sectioning. This directive causes all following 
statements to be associated with a symbolic identifier which can 
later be mapped into a particular memory area. Tt has the 
format: : 


SSECTION identifier 


The SSECTION directive remains in effect until either another 
SSECTION directive is encountered, the $SDEFAULT directive is 
encountered which returns to the default section scheme described 
above, or the end of the module is found. 


NOTE 


Because the assembler automatically calculates the 
displacement used in the Relative addressing mode 
(Section 2.4.6), the target address must be in the 
same section and module as the instruction which 
uses Relative Addressing. 


4.3.2 Location Counter Control 
The assembler keeps track of the "location" of the current 
statement with a location counter, just as an executing program 


does with its program counter. There is a location counter 
associated with each section in a program. The counter value 
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represents a 16-bit offset within the current’ section. The 
offset may be either an absolute value, or it May represent a 
relocatable value which may be adjusted depending on where the 
module's portion of the section is finally allocated at link or 
load time. Relocatable and absolute portions of a section may be 
specified in the same module or program. 


If the S$ABS assembler directive has been specified, the location 
counter reflects the absolute location of the current statement; 
if S$REL has been specified, the counter reflects the relocatable 
offset of the statement. If neither is specified, the counter 
defaults to relocatable offset 0 at the beginning of a module. 
The location counter symbol "S$" may be used in any expression, 
and represents the address of the first byte of the current 
instruction. 


For the majority of programming tasks, one need not specify 
either $ABS or $REL in the source program. Program location can 
be carried out more appropriately at link time or load time. If 
one desires complete control over program location at assembly 
time, however, the SABS directive will force that part of the 
program to reside at a specific location. 


4.3.3 Modes of Arithmetic Expressions 


All arithmetic expressions have one of three modes associated 
with them: absolute, relocatable, or external. 


An absolute expression consists of one or more constants, 
constant identifiers, or absolute labels combined with arithmetic 
or logical operators. The difference between two relocatable 
expressions is also considered to be absolute. 


JP IRQ VECTOR !Where IRQ VECTOR is an absolute 
label! 
ADD Rl, #K*3 !Where K is a constant identifier 
A relocatable expression is one containing exactly one identifier 
subject to relocation after assembly. The expression can be 
extended by adding or subtracting an absolute expression. Plus 
and minus are the only operators. allowed, however. 
JP Z, LOOP+2 !Where LOOP is a relocatable 
label! 
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An external expression is one containing exactly one external 
identifier, possibly extended by adding or subtracting an 
absolute expression. An external identifier is one that is used 
in the current module but defined in another module (Section 
4265) The value of an external identifier is not known until 
the modules are linked. 


LD RO, timer count !External if timer_count was 
defined outside current module! 


In the following summary, "AB" stands for an absolute value or 
expression, "RE" stands’ for a relocatable value or expression, 
and "EX" is an external identifier or expression. "operator" is 
one of the standard arithmetic or logical operators (+, -, *, 
LOR, LAND, etc.). 


"AB" is defined as either: 


an absolute identifier 
AB "operator" AB 

+AB, -AB, or LNOT AB 
RE - RE 


"RE" is defined as either: 


@ a relocatable identifier 

e RE + AB 

@e AB + RE 

@ RE — AB 

@® +RE 
"EX" is defined as either: 

@e an external identifier 

@ EX + AB 

@ AB + EX 

@ EX — AB 

@ +EX 
Certain mode combinations are not permitted in PLZ/ASM. For 
example, a relocatable expression that does not result in simple 
relocation is invalid. Simple relocation means that only a 


single relocation factor need be added to a relocatable value 
when the assembled program is relocated. 


JP Z, LOOP1 + 8 !'VALID -- relocation factor is 
added only once! 


JP Z, LOOP1 + LOOP2 !INVALID -- relocation factor 
would have to be added twice! 
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In general, the second example would be invalid no matter which 
arithmetic or logical operator was used to combine LOOP1 and 
LOOP2. The one exception is subtraction. Suppose LOOP2 is the 
label of the first statement following a procedure named LOOP1. 
The statement 


LD R5, #(LOOP2 - LOOP1) 


could be used to find the length of the LOOP1 procedure. The 
difference between two relocatable labels (which must be in the 
Same section) is always absolute, regardless of where the module 
is relocated to. 


Other invalid mode combinations are: 


@ A relocatable expression multiplied or divided 
by an absolute expression: 


JP Z, LOOP1*4 !INVALID! 


@ A relocatable expression subtracted from an 
absolute expression (although the reverse is 
allowed): 


DJNZ R5, LOOP1 - 8 !VALID! 
DJNZ R5, 8 -— LOOP1 !INVALID! 


@ An external expression combined with a relocatable 
expression, and vice-versa: 


ADD R6, EXTERNAL NUMB + LOOP1 ! INVALID! 
JP Z, LOOP1 - EXTERNAL NUMB !INVALID! 


266 


Section 5 
PLZ/ASM High-Level Statements 


5.1 28000 SOURCE PROGRAM STATEMENTS 


The majority of code in a 28000 PLZ/ASM program will normally be 
the assembly-language instructions described in Section Bie 
Typically, the source program will also include some high-level 
statements and assembler directives. 


High-level statements perform two basic functions: 


e They introduce program structures (modules, 
procedures, DO loops, and IF statements) ; 


@e They declare and define data. 


Assembler directives control the mode of assembly (absolute or 
relocatable), determine where object code is to be stored in 
Memory, and specify the form of assembler output. These 
directives are embedded in the source program and are always 
preceded by a dollar sign ($) (see Appendix C). 


In the descriptions of high-level statements in this section the 
following notational conventions are used: 


e Keywords are shown as all capital letters: MODULE 


® Parameters shown in lowercase letters represent 
items to be replaced by actual data or names: 
module identifier 


@ Optional items are enclosed in square brackets: 
[local_declaration] 


@e Possible repetition of an item is indicated by 
appending a "+" (to signify one or more repetitions) 
or an "*" (to signify zero or more repetitions) to the 
item: declaration* 


@ Other special characters shown in statement and command 
formats such as :=, (), and [] will be enclosed in 
single quotes and must be written as shown. The 
special symbol ":=" means “is defined as" or "is 
assigned". 
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For example: 


CONSTANT 
constant_identifier ':=' constant_expression 
RECORD '‘'[' identifier+ type ']' 


5.2 PROGRAM STRUCTURING STATEMENTS 


5.2.1 Module Declaration 


A 28000 PLZ/ASM program module consists of a sequence of data and 
procedure declarations. These declarations are bounded by the 
module declaration statement and the end-of-module statement. 
The format of a module declaration is: 


module identifier MODULE 
declaration* 
END module identifier 


where 
module identifier conforms to the rules for 
identifiers (Section 2.2.1). 
declaration is zero or more data and/or 
procedure declarations 
(Sections, 5.2.2 and 5.3). 
Example: 


sine computation MODULE 


END sine_computation 


5.2.2 Procedure Declaration 


A procedure declaration defines an executable part of a program 
and associates an identifier with it so that it can be activated 
by the assembly-language CALL statement. 


The procedure heading specifies the identifier naming the 
procedure. This identifier labels the first instruction in the 
Procedure, and can be used as any other program label. The scope 
of the procedure identifier may be either GLOBAL, INTERNAL, or 
EXTERNAL. If the procedure is declared EXTERNAL, then only the 
procedure identifier is given, since the actual definition of the 
Procedure occurs in some other module. A procedure declaration 
May also include local variable declarations. These variables 
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are recognized only within the procedure in which they are 
declared. 


The format of the procedure declaration is: 


procedure identifier PROCEDURE 
[LOCAL 
[variable identifier+ type]*]* 
[ENTRY 
action statement* ] 
END procedure_identifier 


where 
identifier conforms to the rules for 
identifiers (Section 2.2.1). 


type is BYTE, SHORT INTEGER, INTEGER, 
WORD, LONG, LONG INTEGER, LABEL, 
ARRAY, RECORD or a user defined 
type (Sections 5.3.2 through 5.3.4). 


action statement is zero or more assembly-language, 
DO, IF, REPEAT, or EXIT statements, 
Or a combination of these 
statements. 


The keyword ENTRY is used to separate the local variable 
declarations from the executable part of the procedure, and must 
be used whenever any action statements are specified. 


Example: 


EXTERNAL 
print PROCEDURE 


GLOBAL 
suml BYTE 


add routine PROCEDURE 
LOCAL 
sum BYTE 
ENTRY 
LDB RH2,suml 
ADDB RH2,#72 
LDB sum, RH2 
CALL print 
RET 
END add_routine 


Note that the RET instruction precedes the END statement. If RET 


is not present, control will fall through to the statement 
following the END statement. 
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5.2.3 DO Statement 


DO loops provide a framework for performing actions repetitively. 
The statements between the DO and OD keywords are executed 
repeatedly until control is diverted through a loop control 
statement. 


The only way the execution flow of a DO loop can be diverted is 
by encountering an assembly-language branch instruction (DJUNZ, 
JP, JR, CALL, CALR, RET, or IRET) or;an4exXit.or5 REPEAT statement 
(described below). 


The format of the DO loop is: 


[label] * 
DO 
action statement* 
OD a 
where 

label conforms to the rules for labels 
(Sections 2.2.1 and 5.3.5) and is 
used to identify the DO block for 
use with multi-level EXIT and 
REPEAT statements. 

action statement is zero or more assembly-language, 


DO, IF, REPEAT, or EXIT statements, 
Or a combination of these 
statements. 


The assembler automatically inserts a single unconditional jump 
instruction at the OD keyword which branches back to _ the DO 
keyword. Either a JR or JP is generated depending on the range 
of the loop; JR is used whenever possible. 


The EXIT statement causes execution to continue at the first 
statement following the innermost DO...OD block containing the 
EXIT. The EXIT statement may be further qualified by a label 
indicating a specific DO...OD block from which to exit. Its 
format is: 


EXIT [FROM label] 


where 


label conforms to the rules for labels 
(Sections,,202.4, and: 5.33;.5) . 
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The assembler automatically inserts a single unconditional jump 
to the instruction following the indicated OD keyword. Either a 
JR or JP is generated depending on the range of the EXIT, with a 
JR used whenever possible. 


The REPEAT statement causes execution to continue at the first 
statement of the innermost DO...OD block containing the REPEAT. 
It can also be qualified by a label indicating a specific DO...0OD 
block to which execution is to proceed. Its format is: 


REPEAT [FROM label] 


where 
label conforms to the rules for labels 
(Sections 2.2... and 5.:3}<5) « 


The assembler automatically inserts a single unconditional jump 
instruction at the REPEAT statement which branches to the 
indicated DO keyword. Either a JR or JP is generated depending 
on the range of the REPEAT, with a JR used whenever possible. 


Example: 


LOOP1: DO 
ADD RO, @R1 
INC R5, #2 
GP ..R5,,, #L0mijtl 
IF EQ THEN EXIT FI 
DO 
ADD R2, @R3 
INC R6, #2 
CP R6, #limit2 
IF GT THEN REPEAT FROM LOOP1 FI 
OD 
OD 


5.2.4 IF Statement 


The IF statement specifies that the statements between the 
keywords THEN and ELSE (or between THEN and FI if the ELSE clause 
is omitted) are to be executed if the specified condition code is 
true. If the condition is false and the ELSE clause is present, 
the statements between ELSE and FI are executed. If the 
condition is false and the ELSE clause is omitted, execution 
continues with the statement following FI. 


The format of the IF statement is: 
IF condition code 
THEN actionl_statement* 


[ELSE action2_statement*] 
EL 
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where 


condition code PS £72) 2 NZ Cl, SING Pin, (Mir BO; 
NE, OV, NOV, PE, PO, LE, LT, 
GT, GE; ULE; UBT, UGT, or 
UGE (Section 3.2.1). 


actionl statement is performed if "condition_code" 
is true and consists of zero 
Or more assembly-language, DO, 
IF, REPEAT, or EXIT statements 
or a combination of these 
statements. 


action2 statement is performed if "condition_code" 
im is false and consists of zero 
Or more assembly-language, 
DO, IF, REPEAT, or EXIT 
statements or a combination of 
these statements. 


The assembler automatically inserts a single conditional jump 
instruction just before the THEN keyword, which branches to 
either the ELSE clause, if present, or to the FI keyword if not. 
The conditional jump has an opposite sense from the condition 
code given; for instance, "IF OV THEN" generates a "JP NOV" 
instruction. The opposing condition pairs are: Z-NZ, C-NC, 
PL-MI, EQ-NE, OV-NOV, PE-PO, LE-GT, LT-GE, ULE-UGT, and ULT-UGE. 
If the ELSE clause is present, a single unconditional jump is 
inserted just before the ELSE clause which branches to the FI 
keyword. 


For each of the jump instructions, either a JR or JP is generated 
depending on the range of the IF statement, with a JR used 
whenever possible. 


Example: 


IF NZ THEN 
LD counter, #1 
FI 


IF GT 
THEN SETFLG C; RET 


ELSE RESFLG C; RET 
FI 
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5.2.5 IF-CASE Statement 


The IF-CASE statement is an extension of the IF statement. re 
allows the user to select from a series of actions depending on 
the contents of a selector register. The case whose list 


contains a match with the contents of the selector register is 
performed. An ELSE clause can be used to specify alternative 
statements to be executed if no match occurs. If no ELSE is 
specified and no match occurs, the statement following the FI 
keyword is executed next. 


The IF-CASE statement has the format: 
IF selector register 


[CASE expression+ THEN action _statement*]+ 
[ELSE action_statement*] 


FI 
where 

selector register is the designator for a single 
byte, word, or long word 
register (Section 2.4.2). 

expression is any expression which is valid 
aS an operand in a Compare 
instruction. 

action_statement is zero or more assembly- 


language, DO, IF, REPEAT, or 
EXIT statements or a combination 
of these statements. 


The assembler automatically inserts a Compare instruction (CP, 
CPB, or CPL) and a conditional jump for each list element. For 
the last expression in a CASE clause, a "jump NE" to the next 
CASE is generated (or to the ELSE clause, if present, or if not 
present, to the FI keyword for the last CASE). Either a JR or JP 
instruction is used depending on the range of the CASE clause, 
with a JR used whenever possible. When there is more than one 
expression in a single CASE clause, all but the last expression 
generate a "JR EQ" to the start of the action statements 
associated with the CASE clause. Therefore, the number and size 
of expressions for a single CASE clause must not exceed the range 
of the first JR instruction for that clause. 


Example: 


IF R5 
CASE #1, R4 THEN CALL control 1 
CASE #2, @R3 THEN CALL control _gt_l 
ELSE CALL control _gt_4 

FI 
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5.3 DEFINING DATA 


Data (constants and variables) must be defined or declared _ so 
that it can be referenced accordingly. In general, data 
definition associates an identifier with a fixed value or type. 
Data declaration introduces an identifier. as the name of a 
variable and associates a scope and type with it. The following 
three statements are used to define and declare data: 


® The constant-definition statement (CONSTANT), which 
associates a constant identifier with a fixed value; 


e The type-definition statement (TYPE), which associates 
a type identifier with a fixed type; 


@® The variable declaration which associates a variable 
identifier with a scope, type, and (optionally) an 
initial value. 


Constant identifiers are assumed to have INTERNAL scope. 
Constants have no explicit type and are represented as 32-bit 
values. 


Type identifiers appearing in type-definitions are also assumed 
to have INTERNAL scope. No scope or initial value can be 
specified in type-definition statements. They are used primarily 
to categorize data or provide a template for structured data. 


The variable declaration allows a variable identifier to be 
associated with any specific scope, type, or initial value 
(within the limits of the variable's scope). 


5.3.1 Constant Definition 


A constant definition associates an identifier with a constant 
expression. Since this value must be determinable at assembly 
time, any identifier appearing in the expression must be 
previously defined. 


Constant identifiers have no explicit type and are always 
represented as 32-bit values. And, since constants are defined 
at the module level, they have a scope of the module in which 
they are defined (INTERNAL). Constants to be used in other 
modules must be redefined in those modules. 
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The format of the constant-definition statement is: 


CONSTANT 
[constant_identifier ':=' constant_expression]* 
where 
constant_identifier conforms to the rules for 
identifiers (Section 2.2.1). 
constant_expression conforms to the rules for 
constant expressions (Section 
Ze din2)) > 
Example: 
CONSTANT 
minus z=, pd 
count := 10 
NEG COUNT := minus*count 
A SYMB := 'A' 
MODULUS := 256 


5.3.2 Data Types 


Data types are associated with variables either to indicate the 
size of the values the variables can represent or to identify a 
name aS a label. Simple data types indicate whether a variable 
can hold an 8-bit, 16-bit or 32-bit value; structured data types 
provide a template of storage for collections of simple 
variables. The label type is used to declare the scope of labels 
explicitly. 


Data types can be directly associated with variable identifiers 
in variable declarations (Section 5.3.4), or they may be 
associated with variables indirectly using a user-defined "type 
identifier" to specify the type. The latter is an identifier 
that has been previously associated with a type in a TYPE 
statement (Section 5.3.3). In the following example, the 
variable CHAR is associated with the simple type BYTE, allowing 
CHAR to be used as a type identifier in subsequent type 
definitions: 


TYPE 
CHAR BYTE 
letter CHAR 
digit CHAR 


Simple Types. The basic data type is either a standard simple 
data type or a simple data type defined by the user in a type 
definition (like CHAR in the example just given). The standard 
data types are: 


275 


SHORT_INTEGER or BYTE An 8-bit quantity whose value 
can be signed (-128 to +127) 
Or unsigned (0 to 255). This 
value may also represent a 
single character from the 
ASCII character set. 


INTEGER or WORD A 16-bit quantity whose value 
can be signed (-32768 to 
+32767) or unsigned (0 to 
65535). 


LONG INTEGER or LONG A 32-bit quantity whose value 
= can be signed (-2,148,483,648 
to +2,148,483,647) or unsigned 
(0 to 4,296,967,296). 


The values of simple variables (that is, variables defined with 
simple types) are interpreted as signed or unsigned depending on 
their use in assembly-language instructions. 


TYPE 
CHAR BYTE 
small_value BYTE 
large value LONG INTEGER 
letter CHAR 


Structured Types. Structured types are defined by indicating the 
structuring method to be used and the types of all elements 
within the selected structure. Two structuring methods are 
available: ARRAY and RECORD. 


Array Structures. An array structure is a collection of variable 
elements, each of which has the same type. When referenced, the 
identifier associated with the ARRAY type refers to the entire 
array Structure. Arrays with N elements are indexed from 0 to 
N-l; for example, a 10-element array has index 0 as the first 
element and index 9 as the last element. 


Individual elements within an array can be accessed in several 
different ways. A particular element's address may be calculated 
at run-time, for instance, by specifying an indexed address mode. 
At assembly-time, a particular element's address can be specified 
by an expression containing the array identifier and a fixed 
offset or by an array identifier followed by one or more constant 
expressions enclosed within square brackets. In the latter case, 
each constant expression represents an index for the particular 
"dimension" of the array, and the assembler's calculation of the 
desired element's address may involve an implicit multiplication 
by the size of each dimension or by the size (in bytes) of the 
element type (see Section 5.3.4). 


276 


Example: 


TYPE 
STRING ARRAY [26 BYTE] 
INTERNAL 
alpha STRING 
!The array identifier "alpha" is defined as a 26-byte 
array! 


LD R5, #0 

LDB alpha(R5), #'A' 

LDB alphatl, #'B' 

LDB alpha[2], #'C' 

!The first element of array alpha now contains 'A', the 
second element contains 'B', and the third element 
contains 'C'! 


Array definition and initialization are explained in detail in 
Section 5.3.4. 


Record Structures. A record structure is a collection of named 
fields. Unlike array elements, record fields are not required to 
have the same type. For example, a record structure named 
"Strobe" might have a BYTE field named "pin" and a SHORT INTEGER 
field named "voltage". 


TYPE 

strobe RECORD [pin BYTE voltage SHORT INTEGER] 
INTERNAL 

sl strobe 


As this example indicates, a RECORD type definition specifies an 
identifier and a type for each of its fields, as well as an 


identifier for the record structure itself. Individual fields 
can be referenced subsequently by specifying a record variable 
name followed by a period '.' and the field name. 


LDB RL5, sl.voltage 


The scope of a record identifier is specified in the variable 
declaration in which it+.is introduced (or it is implicitly 
INTERNAL if introduced in a TYPE statement). The scope of record 
field identifiers is the module or procedure in which they are 
introduced; in other words, all field identifiers must be unique 
in their entire scope. Record definition is explained in detail 
in Section 5.34. 


Label Type. An identifier with type LABEL can only be used as a 
statement label. The LABEL type declaration is used primarily to 
explicitly specify a label's scope. The scope of a label is 
assumed to be the module in which it appears (that is, INTERNAL). 
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Therefore, statement labels which are to be accessible throughout 
the module need not be declared, although they can be explicitly 
declared INTERNAL for documentation purposes. If a label is to 
have GLOBAL, EXTERNAL, or LOCAL scope, however, it must be 
declared explicitly in a label declaration statement. 


GLOBAL 
TRIG FUNCTION LABEL 


Label declaration is explained in detail in Section 5.3.5. 


5.3.3 Type Definition 


The type-definition statement associates an identifier with a 
fixed type. These identifiers are assumed to have a scope of the 
current module (that is, INTERNAL scope). 


Types are used primarily to categorize data and informally 
associate attributes or properties with the value of the data. 
Types ARRAY and RECORD provide an abbreviated template for 
structured data storage. 28000 PLZ/ASM allows arbitrary 
association of types and data values with no type-compatibility 
restrictions. 


The format of the type definition statement is: 


TYPE 
[type_identifier type]* 


where 
type identifier conforms to the rules for 
identifiers (Section 2.2.1). 


type is BYTE, SHORT_INTEGER, 
INTEGER, WORD, LONG, LONG INTEGER, 
a previously-defined type identifier, 
or is an ARRAY or RECORD type 
definition. 
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Example: 


TYPE 
limitl 
limit2 


LIST 
matrix 


BYTE 
LONG 


ARRAY [128 BYTE] 
ARRAY [10 10 SHORT INTEGER] 


patient RECORD [age height weight BYTE 


char 
letter 
digit 


room WORD 
sex BYTE] 
BYTE 
char 
char 
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5.3.4 Variable Declaration 
The variable declaration statement is used to declare the type of 
variable identifiers and optionally to define their initial 
values. Its basic format is: 

variable identifier+ type [':=' initial_value] 


This format is limited, however, by the scope and type specified. 


Initialization. There are several rules and special symbols used 


for initializations in general. When a single declaration 
contains more than one variable identifier, the corresponding 
initialization values are listed within square brackets. A 
simple variable is initialized using a constant expression. A 
structured variable is initialized using a "constructor", which 


is simply a list of values enclosed by square brackets, with each 
level of nesting within the structure denoted by a matching set 


of brackets. A special symbol, ‘...', indicates ‘that the 
immediately preceding value or constructor is to be repeated for 
the rest of the variables at the current level of nesting. The 


special symbol '?' can be used as a placeholder in a list of 
initial values for simple variables or components of simple type 
within a structure, and indicates that the corresponding simple 
variable remains unassigned. An empty constructor, pee Ve 
indicates that the corresponding structured variable remains 
unassigned. , 


Scope. The scope of the variable declaration can be GLOBAL, 
EXTERNAL, INTERNAL, or LOCAL (Section 4.2.5). The first three 
can be specified only in variable declarations at the module 
level. LOCAL can be specified only at the procedure level. 


An EXTERNAL variable declaration cannot include an initial value. 
The type of the variable can be any simple or structured type, or 
a previously-specified type identifier. Consequently, the format 
of the variable declaration in this case reduces to: 


variable identifier+ type 
Example: 


EXTERNAL 
counter WORD 
input, output ARRAY [72 BYTE] 
customer name STRING 


Simple Variable Declaration. Simple variables are variables 
whose type is BYTE, SHORT_INTEGER, WORD, INTEGER, LONG, 


LONG_INTEGER, or a_ previously specified simple type identifier 
(Section 5.3.2). Simple variables which are GLOBAL, INTERNAL, or 
LOCAL may optionally be given an initial value. 
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Simple variables are initialized in one of two ways: with a 
single constant expression, OY with “a Jhist! of «constant 
expressions enclosed in square brackets. In the first case, only 
one variable may appear in the declaration and is initialized to 
the constant value. If a list is supplied, the variables are 
initialized in left-to-right order from the initial-value list. 
The initial-value list may have fewer items than the 
variable-identifier list, but an error results aig the 
initial-value list is longer. 


Example: 


INTERNAL 
HUE BYTE 
limit WORD := %SFFFF 
total, subtotal BYTE : 
A, Bi, BYTE = -[ VAs 
[0, 1] 


i 
-— 


Array Variable Declaration. An array variable is one whose type 


is ARRAY. An array variable declaration has the format: 


array _identifier+ ARRAY '[' dimension+ type ']' 


[':=" initial value] 
Oni: 
array identifier+ array type [':=' initial value] 
where 
array identifier conforms to the rules for 


identifiers (Section 2.2.1). 


dimension c specifies the number of 
dimensions in the array 
structure and the number of 
elements in each dimension. 
The dimension(s) must be one 
Or more constant expression(s) 
(Section 2.3.2) or a single 
asterisk (*), as detailed 
below. 


type is BYTE, SHORT INTEGER, INTEGER, 
WORD, LONG, LONG INTEGER, a 
previously defined type 
identifier, or is an ARRAY, 
or RECORD type definition. 


array type is a previously-defined ARRAY 
type identifier. 
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initial value is a bracketed list of constant 
expressions, or a character 
sequence as detailed below. 


Several array identifiers may appear in a single declaration, and 
May optionally be initialized if they are declared GLOBAL, 
INTERNAL, or LOCAL. 


Array structures are initialized in left-to-right order from the 
initial values supplied and in row-major sequence (that is, in 
the sequence of ascending memory addresses). For example, a 3x3 
Matrix would be ordered in the following sequence: 

[0,0] [0,1] [0,2] [1,6] [1,1] [1,2] [2,0] [2,1] [2,2] 


Array structures are initialized by a bracketed list of constant 


expressions. If the initial-value list contains "n" items, the 
first "n" elements of the array structure are initialized (in 
row-major Sequence). The number of constants supplied cannot 


exceed the number of elements in the array structure. 
Example: 


INTERNAL 
Matrix ARRAY [10 10 LONG INTEGER] 
list ARRAY [10 BYTE] OF 1 Oi, 
TABLE ARRAY [4 BYTE] [eee ee 


oes LL Dida eta 
ONEDIM1, ONEDIM2 ARRAY [2 BYTE] : 


fl. «al 12s s0ll 


Normally, each dimension specified in the array declaration must 
be a constant expression so that variable upper bounds are 
prohibited. The sole exception is an array declaration 
initializing a one-dimensional array structure. In this case, 
'*' is specified as the dimension and the length of the list is 
determined by the number of items in the initialization list. 
When the '*' feature is used, array structures can be initialized 
in two ways: with a bracketed list of constants as described 
above, or with a character sequence (enclosed in single quote 
Marks). In the latter instance, the array elements must be type 
BYTE, SHORT INTEGER, or a user-defined 8-bit type and each byte 
is initialized to a single character value. 


Example: 
INTERNAL 
list ARRAY [* BYTE] Ms Op lig Oi Oig el 
!This array is only 5 bytes; "list" array in last 


example is 10 bytes, although only 5 are initialized! 


TABLE ARRAY [* BYTE] := ‘'TODS' 
!Compare to TABLE array in last example! 
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Record Variable Declaration. A record variable is a variable 
whose type is RECORD. A record variable declaration specifies an 
identifier for the record as a whole and an identifier and type 
for each field within the record. A field type may be ARRAY or 
RECORD, as well as a simple type. 


A record variable declaration has the format: 


record identifier+ RECORD *[' [field_identifier+ type]+ "]' 


[o2=) init ralevaluel 
or: 
record identifier+ record type 
[':=" initial_valute] 
where 
identifier ~ conforms to the rules for identifiers 


(Sectton 2.2.1): 


type is BYTE, SHORT _ INTEGER, WORD, INTEGER, 
LONG, LONG INTEGER, a previously-defined 


type identifier, or is an ARRAY or 
RECORD type definition. 


record type is a previously-defined RECORD type 
identifier. 


initial value is a bracketed list of constant 
expressions. 


Several record identifiers may appear in a single declaration, 
and may optionally be initialized if declared GLOBAL, INTERNAL, 
or LOCAL. Each record field is initialized in left-to-right 
order from the values given in the initial list. A list of "n" 
values enclosed by square brackets may be given, with the first 
"n" fields being initialized. Having more constants than the 
total number of record fields is flagged as an error. 


Example: 


GLOBAL 


person RECORD [age, height, weight BYTE 
birth RECORD [day, month, year BYTE] 
salary WORD] 


MSG RECORD [length BYTE char ARRAY [50 BYTE]] :=[0[0]] 


!length field and first byte of char array 
are initialized to zero! 


If an array or record appears within another array or record, 
then this nesting is represented by enclosing each level of 
initialization values within square brackets. Notice that in 
this case, the last record fields or array elements at each level 
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do not have to be specified. Furthermore, if more than one 
structured variable identifier appears in a single declaration, 
then the part of the initial value list corresponding to each 
structured variable must also be enclosed by square brackets. 


TYPE 
PATIENT RECORD [ ROOM WORD 
BIRTH RECORD [DAY,MO,YR BYTE] 
SEX BYTE] 
INTERNAL 
FEMALE ARRAY [100 PATIENT] :=[[?,[],'F']...] 
tonly the SEX field of each record is initialized! 


Alignment. If the current location counter value is even, then 
any data variable or instruction may start at that address. 
However, if the current location counter value is odd, then only 
8-bit values may start at that address. The assembler 
automatically aligns simple variables so that word (WORD or 
INTEGER) or long word (LONG or LONG INTEGER) variables are 
located at even addresses. This is accomplished by inserting a 
byte with an undefined value when the location counter value is 
odd, thus forcing the word or long word to stert at the next 
higher even address. Instructions within a procedure are also 
automatically aligned. 


Structured variables are, in general, automatically aligned; that 
is, all array or record variables are forced to start at an even 
address (an undefined byte value is inserted if the location 
counter was odd). An exception to this rule is made for arrays 
whose elements are any 68-bit type (based on BYTE or 
SHORT INTEGER), which do not have to be aligned on an even 
address boundary. 


It is the programmer's responsibility to ensure that all 
variables within a structure are aligned properly. The 
programmer should be careful to align record fields on their 
appropriate address boundaries relative to the start of the 
record. This can be accomplished by defining "filler" fields 
where necessary to force the alignment of the following field. 
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5.3.5 Label Declaration 


The label declaration statement specifies that an identifier is 
used in the program as a statement label. It cannot be used for 
any other purpose within its defined scope. The format of the 
label declaration is: 


label _declaration+ LABEL 
where 


label_ identifier conforms to the rules for 
identifiers in Section 2.2.1. 


Note that the colon (:) that follows a label identifier when it 
appears in an executable statement (Sectuon. 272°. 1") iss mort 
included when the label is identified in a label declaration 
statement. Note also that labels cannot be given an initial 
value (that is, the label declaration cannot be used to assign 
absolute addresses). 


A label can have GLOBAL, EXTERNAL, INTERNAL, or LOCAL scope 


(Section 4.2.5). If a label is used in an executable statement 
without being declared ina label declaration statement, it is 
assumed to be INTERNAL to the module in which it appears. This 


default scope can be overridden by explicitly declaring the scope 
of the label. 


Notice that a label with LOCAL scope must be declared in the 
procedure declaration before the ENTRY keyword; that is, before 
the label is used or defined, whereas a label with GLOBAL, 
EXTERNAL, or INTERNAL scope may be used before it is either 
declared or defined. To allow the programmer to avoid 
pre-declaring LOCAL labels, 28000 PLZ/ASM provides a special form 
of statement labels which are always of LOCAL scope and cannot be 
declared explicitly. The form of a special label is a dollar 
sign "$", followed immediately by any valid decimal number, and 
it can be used in the same manner as a regular statement label 
identifier, except that its scope is always limited to the 
procedure in which it is defined. 


285 


Example: 


GLOBAL 
STEP3 LABEL 


processl0 PROCEDURE 
LOCAL 
A;o,e  EBMEE 
STEP2 LABEL 
ENTRY 
STEEL: s< 


!Procedure has GLOBAL scope! 


ISTEP] has INTERNAL scope! 


!STEP2 is LOCAL to 


"processl0"! 


!ISTEP3 has GLOBAL scope! 


!Sl is LOCAL to "processl0"! 


END process1l0 


5.3.6 SIZEOF Operator 


28000 PLZ/ASM includes a special unary operator, SIZEOF, which 
operates on type identifiers to determine the size (in bytes) of 
a variable field. Although SIZEOF can be used with any type, it 
is useful for sizing arrays, records, and user-defined types. 


DY PE 
char BYTE 
digit char 
matrix ARRAY [10 10 WORD] 
patient RECORD [height weight BYTE 
room WORD] 


LD RO, #SIZEOF digit !RO contains 1! 
LD Rl, #SIZEOF matrix IR] contains 200! 
ED RI, #(SIEZZEOP matrix/ 

SIZEOF WORD) !R1 contains 100! 
LD R2, #SIZEOF patient !R2 contains 4! 
LD R3, #SIZEOF patient.weight !R3 contains 1! 
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Appendix A 
High-Level Statement Summary 


The following list summarizes the high-level keywords and their 
uses. 


ARRAY 


BYTE 


CASE 


CONSTANT 


DO 


ELSE 


END 


ENTRY 


EXIT 


EXTERNAL 


FI 


FROM 


One of the two structured variable 
types. Used in type definition and 
variable declaration statements. 


One of the simple variable types. 
Used in type definition and variable 
declaration statements. 


Used in IF conditional-execution 
statement. Instruction(s) following 
CASE definition are executed if one 
of the specified values matches 
selector register. 


Introduces constant definition(s). 
Introduces DO loop. 

Used in IF conditional-execution 
statement. Statements between ELSE 
and FI are executed if the specified 
condition is false. 


Module or procedure terminator. 


Marks beginning of action-statement 
part of a procedure. 


Loop control statement used to 
control execution flow of a DO loop. 


Specifies that variables and/or 
procedures defined as GLOBAL in 
another module will be used in the 
current module. 

IF statement terminator. 


Used in conjunction with EXIT and 
REPEAT loop control statements. 
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GLOBAL 


IF 


INTEGER 


INTERNAL 


LABEL 


LOCAL 


LONG 


LONG INTEGER 


MODULE 

OD 
PROCEDURE 
RECORD 
REPEAT 


SHORT_INTEGER 


THEN 


Declares variables and/or procedures 
to have a scope of the entire 
executable program. 


Introduces IF statement. Code 
following IF-THEN is executed if the 
specified condition is true. 


One of the simple variable types. 
Eguivalent to WORD. 


Declares variables and/or procedures 
to have a scope of the current module 
only. 


Used to declare statement label 
scope explicitly. 


Declares variables to have a 
scope of the current procedure only. 


One of the simple variable types. 
Used in type definition and variable 
declaration statements. 


One of the simple variable types. 
Equivalent to LONG. 


Introduces a module. 
DO loop terminator. 
Introduces a procedure. 


One of the two structured variable 
types. Used in type definition and 
variable declaration statements. 


Loop control statement used to 
control execution flow of a DO loop. 


One of the simple variable 
types. Equivalent to BYTE. 


Used in IF conditional-execution 
block. The statements between THEN 
and ELSE (or THEN and FI if ELSE is 
omitted) are executed if the 
specified condition is true. 


TYPE Introduces type definition(s). 
WORD One of the simple variable types. 


Used in type definition and variable 
declaration statements. 


The remainder of this appendix contains the complete grammar for 
Z8000 PLZ/ASM. In this grammar: 
@ Keywords are shown as all uppercase letters; 


@ Required special characters are enclosed in ‘single 
quotes'; 


@ Optional items are enclosed in [square brackets]; 

@ Possible repetition of an item is shown by appending 
a "+" (to signify one or more repetitions) or "*" 
(to signify zero or more repetitions) to the item; 


@ Parentheses are used to group items to be repeated; - 


@e A vertical bar "|" signifies that an alternative 
follows. 
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PLZ/ASM GRAMMAR - MODULE SYNTAX 


module 


declarations 


constants 


types 


globals 


internals 


externals 


constant_definition 


expression 


arithmetic_expression 
term 


factor 


module identifier MODULE 
declarations* 
END module _ identifier 


constants 
types 
globals 
internals 
externals 


CONSTANT 
constant_definition* 


AD oO} 
type definition* 


GLOBAL 
var_or proc _decleration* 


INTERNAL 
var_or_ proc declaration* 


EXTERNAL 
restricted _var_or_proc_declaration* 


constant _identifier 
':=' expression 


arithmetic_expression 
[rel op arithmetic_expression]* 


term [add_op term]* 


factor [mult_op factor ||* 
unary operator factor 
'(' expression ')' 
SIZEOF type identifier 
constant_identifier 
label 

variable 

number 

character constant 


character constant => 


type definition => 
type => 
=> 
simple type => 
=> 
structured type => 
=> 
array type => 
=> 
record type => 
=> 
field declaration => 


var_or_proc_ declaration 


variable declaration =? 


character _ sequence 


type identifier type 
simple type : 
structured type 

BYTE 

WORD 

LONG 

SHORT INTEGER 


INTEGER 
LONG INTEGER 
simple type identifier 


array type 
record type 


ARRAY '[' expression+ type "]' 
arbrayatype wdentiftirer 


RECORD '[' field declaration+ ']' 
Lecorducype identifier 


field _identifier+ type 
variable declaration 

procedure declaration 

variable noinitial_ declaration 


variable initial declaration 
label declaration 


restricted _var_or_ proc declaration 


=> 
=> 


identifier+ type 
procedure identifier PROCEDURE 


variable noinitial_ declaration 


=? 


identifier+ type 
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variable initial declaration 


constructor 
initial _component 
initial value 
label _ declaration 
variable 

array variable 


array designator 


record variable 


record designator 
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=> 


identifier simple _ type 

':=' initial value 

identifier identifier+ simple type 
Feat Fit intial value* 

[Stead ey ¥ 4)" re 

identifier structured type 

's='" constructor aa 

identifier identifier+ structured type 
t=" Wilnconstructor* 

eokstea|| at 

identifier ARRAY 

Witty *tasimphe type *"]" 

tou!" {)- initial valuet+ ‘|’ 
identifier ARRAY 

'[','*!. simple type ']! 

:=' character _sequencet 


'({' initial component* 


[aveeekaeke: 


initial _value 
constructor 


expression 
to! 


label _identifier+ LABEL 


identifier 
array_variable 
record variable 


array designator 
'[' expression+ ']' 


array_identifier 
record variable 
array variable 


record designator 
"." field identifier 


record identifier 
array variable 
record variable 


procedure declaration => procedure identifier 
PROCEDURE 
locals* 
[ENTRY 
statement* ] 
END procedure identifier 


locals => LOCAL 
variable declaration* 


statement => [label ':'] statement 
=> loop statement 
=> exit statement 
=> repeat_statement 
=> if statement 
=> select _statement 
=> assembler_instruction 


loop statement => DO 
statement* 

OD 

label => label_identifier 
=> 'S' decimal constant 

exit statement => EXIT [FROM label] 
repeat_statement => REPEAT [FROM label] 
if statement => IF condition_code THEN statement* 


[ELSE statement*] FI 
select_statement => IP seliector register 

select _elementt 

[ELSE statement*] FI 


selector register => register 


select_element => CASE expression+ 
THEN statement* 


rel_op tel aes [ee US USI IIR Mee Sah Si 8 
add_op = tee HOR: || GXOR 

mult _op => svete | GAND™ | *MOD- |" SHE SHR 
unary operator ete eee ee NOL 

assembler instruction => operation operand* 

Operation => 28600 instruction 
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register 

indirect register 
immediate 

indexed address 
based_address 
based_indexed_address 
direct_address 
relative address 
condition code 
flags 

int 


operand 


A Re Ss 
SP PMNS OSE SNE NOON NON 


register => single register 
=> double register 
=> low_byte register 
=> high _byte register 
=> quad register 
=> special register 


single register soyRO. | RL | R2 | RB | Ra | RS. | 
RG | Riad BS | Ro | RIO | RL | 
R12 | RUS || R14 | RIS 


double register => RRO | RR2 | RR4 | RR6 | 
RR8 | RR1O | RR12 | RR14 

low_byte register => REO || “REL | REZ | RES | 
RL4 | RL5 | RL6 | RL7 

high_byte_ register => RHO | RH1 | RH2 | RH3 | 
RH4 | RH5 | RH6 | RH7 

quad_ register => RQO | RQ4 | ROB | RQI2 

indirect_register => '@' register 

immediate => '#' expression 


=> '#' SEG expression 
-> '#' OFFSET expression 


indexed_address => address designator 
'(? register ")" 


based address => register, "(! immediate *) ’ 
based_indexed_address => register: "(Ll register "))’ 
direct_address => address designator 
relative address => address designator 
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address designator 


seg_address designator 


condition code 


Special register 


flags 


int 


seg_address designator '|' 
seg_address designator 


expression 
expression '>>' expression 


Veet 


FCW 


Nz | 
NC | 


| 


GT 
PO 


EQ | NE | MI | 
Ov | NOV | LT 


ULT | UGE | ULE 


PL 


GE 
| 


FLAGS | NSP | NSPOFF 


NSPSEG | 
PSAPSEG 


PSAP | PSAPOFF 
REFRESH 


| 


| 
UGT 
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28000 instruction => ADC | ADCB | ADD | ADDB | ADDL | 
AND | ANDB | BIT | BITB | CALL | 
CALR | CLR | CLRB | COM | COMB | 
COMFLG | CP | CPB | CPL | CPD | 
CPDB | CPDR | CPDRB | CPI | CPIB | 
CPIR | CPIRB | CPSD | CPSDB | CPSDR | 
CPSDRB | CPSI | CPSIB | CPSIR | 
CPSIRB | DAB | DBJNZ | DEC | DECB | 
Dr | DEV) |SDIVL | DINZ | EXT | Ex | 
EXB | EXTS | EXTSB | EXTSL | HALT | 
IN | INB | INC | INCB | IND | INDB | 
INDR | INDRB | INI | INIB | INIR | 
ENERB iiGERET | JP | JR | LD | LDA | 
BDAR |yaDBel] LDCTL | LDCTLB. | 
LDD | LDDB | LDDR | LDDRB | LDI | 
LDIB | LDIR | LDIRB | LDK | LDL | 
LDM | LDPS | LDR | LDRB | LDRL | 
MBIT | MREQ | MRES | MSET | MULT | 
MULTL | NEG | NEGB | NOP | OR | 
ORB | OTDR | OTDRB | OTIR | OTIRB | 
our | OUTB | OUTD | OUTDB | OUTT | 
OUTIB | POP | POPL | PUSH | PUSHL | 
RES | RESB | RESFLG | RET | RL | 

| RLC | RLCB | RLDB | RR | RRB | 
RRC | RRCB | RRDB |SBC | SBCB | SC | 
| 


SDA | SDAB | SDAL | SDL | SDLB | 
SDLL SET | SETB | SETFLG | SIN | 
SINB | SIND | SINDB | SINDR | SINDRB | 


| 
| 
SINI | SINIB | SINIR | SINIRB | SLA | 
SLAB | SLAL | SLL | SLLB | SLLL | 
SOTDR | SOTDRB | SOTIR | SOTIRB | 
souT | SOUTB | SOUTD | SOUTDB | 

SOUTI | SOUTIB | SRA | SRAB | SRAL | 
SRL | SRLB | SRLL | SUB | SUBB | 

SUBL | SWAP | TCC | TCCB | TEST | 
TESTB | TESTL | TRDB | TRDRB | TRIB | 
TRIRB | TRTDB | TRTDRB | TRTIB | 
TRTIRB | TSET | TSETB | XOR | XORB 
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PLZ/ASM GRAMMAR —- LEXICAL SYNTAX 


PLZ text 
id_constant_text 
separator 


identifier 


constant 


number 


decimal constant 
hex_constant 
octal_constant 
binary constant 
character sequence 


string text 


string char 


special string text 
special string char 
letter 


bin_digit 


oct_digit 


separator* 


[id_constant_text] 


(separator+ id_constant_text)* 


identifier 
constant 


delimiter text 
special symbol 
Vetters(letter  |- digit | 


number 
character sequence 


decimal constant 
hex_constant 

octal constant 
binary constant 
digit+ 

Pe hex idiigast+ 
Sti(8) Oct digit+ 

Mr (Z)) el oalinve lake fata ers 
ecm nGmtenct 0" 


string char 
special string text 


any_character_except_% or_' 


'$' special string char 
'$' hex digit hex digit 


'R! | 'y,! | tm | 'p! | YOu 
mre | i) | ig Bi | Spe | ‘qi 
‘A! | 'B! | ee | wz | 

vat | Ut ony | pe es | Ng! 

‘QO! | Es [al 

ro | Ta | eH] | Wars | 

wg | S! | "6! | 7! 


')* 
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digit 


hex_digit 


special symbol 


delimiter text 


comment 


delimiter 
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9! | Up | 123 | 13)! | og’ | 
ee | "6" | Li os | 'g! | tg! 
i a | Li | 121 | '3' | ‘ge | 
PB | LK 4 | 17° | 'g! | tQ! | 
"A! | 'B! | re | tp! | 'R! | 
vat | "bp! | Dig t | Sait | Tet | 
48 | ee | | t* 8 | , t ee ie © 
er | '. | ee hd ,| gg! | “e | 
Le TP | ri | Uy | my | hes | 
tt | tet | t>! | '<=at | t>=! 
"ee! | Syl | LB 

delimiter 

comment 

"UY any character €xcept § '! 
Leaqdespacec! '," | 

tab | formfeed | linefeed | 


carriage return 


Appendix B 
Assembler Directives and 
Extended Instructions 


B.-1 ASSEMBLER DIRECTIVES 


The following is a summary of some of the assembler directives 
used to control the operation of the 28000 assembler. Other 
directives are explained in detail in the 28000 Assembler User's 
Guide. 


These directives can be embedded in the source program, and 
always start with a dollar sign "$", immediately followed by the 
particular directive and then any operands. For example, a 
programmer may want to fix the address for a procedure: 


SABS 12 
The assembler directives are: 


SABS [location] Specifies that the object code produced 
is to be absolute. If "location" is 
specified, the location counter will 
be set to that value and the assembler 
will begin assigning absolute addresses 
from that location. "Location" ~"1st be 
a constant expression. S$ABS rema 1s in 
effect until a $REL directive is 
encountered. 


SREL [location] Specifies that the object code produced 
is to be relocatable. If "location" 
is specified, it is a relocatable 
offset from the beginning of the 
current section. "Location" must be a 
constant expression. S$REL remains 
in effect until S$ABS directive is 
encountered. S$REL 0 is the default at 
the start of module assembly. 


S$SDEFAULT Cancels the effect of the S$SECTION 
assembler directive and restores 
default memory assignment. Data 
declarations reside in the data 
section and procedure declarations 
reside in the program section. 
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$SECTION identifier Causes the object code produced to be 
associated with a symbolic identifier 
which can be used later for mapping 
into one of the memory areas. 
Remains in effect until either 
another S$SECTION directive is 
encountered, or until a SSDEFAULT 
directive restores default memory 
assignment. 


B.2 EXTENDED INSTRUCTIONS 


The following three "extended" instructions may be placed within 
a procedure as a one-operand assembly language instruction and 
produce an arbitrary byte, word, or long word value. 


BVAL constant_expression Defines a byte value to be 
located at the current location 
counter. Can be used to 
"create" Z8000 instructions or 
data. 


WVAL constant_expression Defines a word value to be 
located at the current location 
counter. Can be used to 
"create" 28000 instructions or 
data. 


LVAL constant_expression Defines a long word value to be 
located at the current location 
counter. Can be used to 
"create" Z8000 instructions or 
data. 
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Appendix C 
Reserved Words and Special Characters 


C.1 RESERVED WORDS 


Certain special symbols are reserved for 28000 PLZ/ASM and can 


not be redefined as symbols by the programmer. These are the 
names of operators, condition codes, register symbols, assembly 
language instructions, and high-level statement keywords. The 


specific reserved words are listed below. 


NAMES OF OPERATORS 


LAND OFFSET 
LNOT SEG 
LOR SHL 
LXOR SHR 
MOD SIZEOF 


STATUS FLAGS AND CONTROL BITS 


Cc Vv 
NVI vi 
E: Z 
S 


CONDITION CODES 


c LE NE PE UGT 
EQ LT NOV PL ULE 
GE MI NZ PO ULT 
GT NC OV UGE Z 


CONTROL REGISTER SYMBOLS 


FCW PSAP 
FLAGS PSAPOFF 
NSP PSAPSEG 
NSPOFF REFRESH 
NSPSEG 
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ASSEMBLY LANGUAGE INSTRUCTIONS 


ADC CPSD IND LDM POPL SETB SOUTIB 
ADCB CPSDB INDB LDPS PUSH SETFLG SRA 
ADD CRSDR INDR LDR PUSHL SIN SRAB 
ADDB CPSDRB INDRB LDRB RES SINB SRAL 
ADDL CREST INI LDRL RESB SIND SRL 
AND CPSIB INIB MBIT RESFLG SINDB SRLB 
ANDB CPSIR INIR MREQ RET SINDR SRLL 
BIT CPSIRB INIRB MRES RL SINDRB SUB 
BITB DAB IRET MSET RLB SINI SUBB 
CALL DBJNZ JP MULT RLC SINIB SUBL 
CALR DEC JR MULTL RLCB SINIR TCC 
CLR DECB LD NEG RLDB SINIRB TCCB 
CLRB DI LDA NEGB RR SLA TEST 
COM DIV LDAR NOP RRB SLAB TESTB 
COMB DIVL LDB OR RRC SLAL TESTL 
COMFLG DJNZ LDCTL ORB RRCB SLL TRDB 
CP EI LDCTLB OTDR RRDB SLLB TRDRB 
CPB EX LDD OTDRB SBC SLLL TRIB 
CPL EXB LDDB OTIR SBCB SOTDR TRIRB 
CPD EXTS LDDR OTIRB sc SOTDRB TRTDB 
CPDB EXTSB LDDRB OUT SDA SOTIR TRTDRB 
CPDR EXTSL LDI OUTB SDAB SOTIRB TRTIB 
CPDRB HALT LDIB OUTD SDAL SOUT TRTIRB 
CPL IN LDIR OUTDB SDL SOUTB TSET 
CPIB INB LDIRB OUTI SDLB SOUTD TSETB 
GPTR INC LDK OUTIB SDLL SOUTDB XOR 
CPIRB INCB LDL POP SET SOUTI XORB 


When defining symbols, users should also avoid the forms Rn, RHn, 
RLn, RRn, and RQn where n is a number from 0 to 15. 

EXTENDED INSTRUCTIONS 

BVAL 


LVAL 
WVAL 


HIGH-LEVEL STATEMENT KEYWORDS 


ARRAY END GLOBAL LONG REPEAT 

BYTE ENTRY 1G) LONG INTEGER SHORT_INTEGER 
CASE EXIT INTEGER MODULE THEN 

CONSTANT EXTERNAL INTERNAL OD TYPE 

DO FI LABEL PROCEDURE WORD 

ELSE FROM LOCAL RECORD 
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C.2 SPECIAL CHARACTERS 


The list of special characters below includes delimiters and 
special symbols. The difference between them is that delimiters 
have no semantic significance (for example, two PLZ/ASM tokens 
can have any number of blanks separating them), whereas’ special 
symbols do have semantic meaning (for example, # is used to 
indicate an immediate value). 


The class of delimiters includes the space (blank), tab, form 
feed, line feed, carriage return, semicolon (;), and comma (,). 
The comment construct enclosed in exclamation points (!) is also 
considered a delimiter. 
The special symbols and their uses are as follows: 

it Binary addition; unary plus. 


- Binary subtraction; unary minus. 


ss Unsigned multiplication; dimension specifier for 
list (one-dimensional array) initialization. 


7, Unsigned division. 


: Label terminator. 


Constant and variable initialization. 


% Nondecimal number base specifier; special 
character specifier within quoted character 
sequence. 


# Immediate data specifier. 
@ Indirect address specifier. 
$ Current contents of location counter; specifies 


special LOCAL statement labels; precedes 
assembler directives. 


{] Enclose components of ARRAY or RECORD definition; 
enclose index part of ARRAY reference; enclose 
initialization values. 


() Enclose expressions selectively; enclose octal or 
binary number base indicator; enclose index part 
of indexed, based, and based indexed address. 


5 Separates RECORD name from field name in RECORD 
field reference. 
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< "Less than" operator 
> "Greater than" operator. 


a "Equal" operator. 


<> "Not equal" operator. 

<= "Less than or equal" operator. 

>= "Greater than or equal" operator. 

? Placeholder in initialization lists. 

iets Repetition symbol in initialization lists. 
<< >> Denotes segmented address. 


el Enclose short offset segmented address. 
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Introduction to RIO Text Processing 


| 


YET 


S—) 


} 


ne 
= 0,0 


we 


SECTION 1 


SECTION 2 


SECTION 3 


SECTION 4 


SECTION 5 
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SECTION 1 


INTRODUCTION 


Using a computer text editor to prepare a document is 
similar to using a typewriter. The difference is that with the 
computer, making changes to text is much easier. 


The purpose of this document is to give a general overview 
of how to use the RIO text editor. RIO is an interactive 
computer system, meaning you and the system can communicate with 
each other by means of a keyboard terminal electronically 
connected to the computer. 


This document has been designed with the beginner in mind. 
Those already familiar with text editing may wish to start with 
the Z-80 RIO Text Editor User's Manual (see Section 5). After 
you have learned the fundamentals of RIO text editing, refer to 
other Zilog documents (see Section 5), which have been designed 
for the more experienced user. 


Learning to use the RIO text editor is like learning 
anything else -- once you become familiar with it, it will seem 
easy. Try to spend a few uninterrupted hours getting to know 
your system.” As you read through this manual, put into practice 
what you learn. Don't just read about it, try it. 
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SECTION 2 


GETTING STARTED 


2.1 The Computer System 


The first step in learning about RIO text editing is to 
become familiar with your computer system. 


There are three basic parts: 
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ee 


The computer: The basic unit of your computer system 
(see Figure 1) is where all the information is processed 
-- it is the "brain" of your system. 


The information necessary for the computer's operation is 
stored on magnetic disks. These are housed in 
protective, square coverings with window cut-outs that 
expose the disk. The disks are inserted into two "disk 
drives" to receive information from, or supply 
information to, the computer. The disk that contains 
information necessary to run RIO is called the System 
Disk, and usually goes into the rightmost drive (Drive 
0). The disk on which your data is stored is called the 
User Disk. It is inserted into the left drive, which is 
Drive 1 or 2, depending on your system. 


The type of system you have appears on the front panel of 
your computer. In a Microcomputer Zilog (MCZ), the left 
drive is called Drive 2. In a Zilog Development System 
(ZDS), the left drive is called Drive 1. In this manual 
the left drive will always be referred to as Drive 2. If 
you have a ZDS, don't forget to always use "1" when "2" 
is specified. 


CAUTION ? 


When handling disks, be sure not to touch 
the exposed window areas. This could damage 
information stored on the disk. 


The keyboard: A keyboard similar to a typewriter is used 
to enter information into the computer. Note that the 
numerical keys "0" and "1" (zero and one) can never be 
interchanged with the uppercase letter "O" and lower case 
letter "1", respectively when giving commands to the 
system. 


The key marked RETURN is the carriage return. After a 
command to the computer is given, this key must be 
pressed to execute the command. 


WRITE PROTECT TAB 


2 


at DISK DRIVE 
-* DRIVE1 DRIVEO 
o . RELEASE BAR 


Figure 1. Zilog Computer System 


The CAPS ONLY key is similar to the shift lock ona 
typewriter keyboard. The difference is that when the 
CAPS ONLY light is on, only letters are capitalized. To 
type special symbols (!, ", %, $, etc.) you must still 
press SHIFT while pressing the appropriate key. 


To correct a typing mistake press the BACKSPACE key. 

This deletes the last character typed. On keyboards 
without the BACKSPACE key, the last character is deleted 
by holding down the CNTL (control) key while striking the 
"H" key. 
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Pressing the DEL (or RUBOUT) key, erases the entire 
current line. The current line is the last line typed. 


The console: As you type on the keyboard, what you type 
is displayed on a console. This is either a 
television-like video screen or a printed paper output 
device (line printer). The video screen is sometimes 
referred to as the CRT, (which stands for Cathode-Ray 
Tube), the terminal screen, or sometimes simply the 
terminal. "Terminal" actually refers to both the 
keyboard and the console. 


2.2 Getting the Computer System Ready 
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There are four simple steps to take before you can 
use the text editor: 


A 


NOTE: 


Turn your system on: There are on/off switches on the 
console and the computer. If there is a LINE key on your 
keyboard, make sure the indicator on the key is lit; LE 
not, press the key. 


Load the disks: Obtain newly formatted system and user 
disks. Formatted disks have fixed, addressable segments 
-- i.e., they are usable. The formatting procedure will 
be discussed later in Section 4. Insert the System Disk 
into Drive 0 by sliding it in with the seamed side facing 
left and the notch in the upper corner (see Figure 1). 
When it has clicked into place, close the drive door by 
sliding it to the left. In the same manner, insert the 
User Disk into Drive 2. 


Bootstrap: Bootstrapping gets the computer ready to 
accept commands. Do this by pressing the RESET button on 
the computer and the RETURN on the keyboard. A 
successful Bootstrap results in a "%" on the terminal 
screen. This is called a "prompt", and means the 
computer is ready to accept commands. 


Initialize: Type an "I" after the prompt and strike the 
carriage return. 


The Initialize command should always be the first command 
entered after you insert a disk. This step will not be 
indicated throughout the manual, so it is important to 
get into the habit of typing an "I", followed by a 
carriage return, each time you insert a disk. 


2.3 Getting Information into the Computer (Files) 


Information is stored on the disks in files. Imagine files 
as individual documents, which you call forth at will to change 
or print into a hard-copy (computer slang for the actual 
ink-on-paper representation of what a file contains). Each file 
has its own name, so it can be easily located by the computer. 


Creating a new file on the computer is like creating a new 
document on a typewriter. The disk holds the information you 
enter on the keyboard just as a piece of paper in a typewriter 
holds what you type. 


You can easily obtain a hard-copy of a file with a line 
printer. Most systems are not connected to a printer, but there 
is usually one somewhere close by. There are many kinds of 
printers, so when you are ready to use one you will need to 
consult your local electronics wizard to learn how. 


2.4 Creating a File 


You are now ready to create a file. The first one you 
create, by following the steps in the manual, will be simple and 
short, but it will give you a good idea of how to create your own 
files in the future. The name of this file will be APHORISMS. 


Make sure the prompt (%) sign is visible on your screen; if 
not, Bootstrap. 


There will be two things going on in all of the following 
instructions -- you will be typing on the keyboard to the 
computer, and the computer will be answering you on your console. 


In all of these instructions, what you are supposed to type 
will be in boldface, what the computer responds is not boldfaced, 
and a right arrow ("--->") will represent a carriage return. 

Most commands to the computer are typed in uppercase letters. 


With all of this in mind, type: 
%EDIT APHORISMS ---> 
EDIT (1.6 


NEW FILE 
INPUT 
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When you type EDIT APHORISIMS, you are specifying an action 
and naming a file. The computer searches its memory (searches 
through all the pre-existing files), and, in this case, because 
it cannot locate a file named APHORISMS, it states that APHORISMS 
is a new file. Don't be concerned if your computer responds with 
some number other than 1.6 after EDIT, as this is simply a 
release number for your System Disk. 


When you create a file, you use the RIO Text Editor. "Edit" 
is a function on your RIO system that makes it easy to prepare 
written material for presentation or publication. To edit a 
file, you must be in "Edit mode". 


When you type "EDIT APHORISMS" you are put in Edit mode. 
When the file you are editing is a new file, as in this case, the 
computer goes one step further and puts you in "Input mode". 
Input means that you may now add text to a file. The computer 
tells you that you are in Input mode by not issuing a prompt. If 
the last line on your console contains a ">", type "INPUT" and a 
carriage return. 


CAUTION 


The Percent-Sign prompt (%) has disappeared 
from the last line, so do not remove your 
disks. Only remove them when the "%" 

prompt is present and the red lights on 

the disk release bars are off. Removing 
disks at the wrong time can cause file damage. 


When entering the aphorisms that follow, insert carriage 
returns so your aphorisms look the same as those in this manual. 


Carriage returns will not be indicated here for the straight 
input of text. 


Type into the computer: 


A penny saved 
is a penny earned. 


You will often want to skip spaces between paragraphs or 
sections when inputting text. You can't, however, accomplish 
this by repeatedly pressing the carriage return. Instead, for 
each additional blank line you want, press the carriage return 
once, touch the long space bar (character space) at the bottom of 
the keyboard, and then press the carriage return again. If you 
type two successive carriage returns you will go out of Input 
mode. If a ">" appears before you are done inputting, type "I", 
carriage return, and continue where you left off. Typing "I" 
after a right angle bracket prompt (>) means “put me in Input 
mode". Note that this is different from typing an "I" after a 
percent sign prompt (%), which means "Initialize". 
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Double-space after your last aphorism, and add these golden 
words to your collection: 


A stitch in time saves nine. 
Into each life a little rain must fall. 
Every cloud has a silver lining. 


A rolling stone 
gathers no moss. 


You can lead a horse to water, 
but you can't make it drink. 


2.5 Closing a File 


To close the aphorisms file, you must go from Input mode 
back into Edit mode. You entered Edit mode when you opened the 
file. The ">" prompt indicates that you are in Edit. Close your 
file by hitting a carriage return twice. On your console will 
appear: 


EDIT 
> 


To get out of Edit mode, type: 


>QUIT ---> 
% 


When the prompt is present and the red lights on the disk 
release bars are off, remove the disks by pressing the bars -- 
the disks will pop out. 


This is a good time to make a hard-copy of your APHORISMS 
file if you have a printer available. 


2.6 Creating a Backup for Files 


You will shortly make changes to your APHORISMS file, but 
before doing so, you should make a backup disk. Keep this disk 
only for backing up files. In this way you will have an exact 
copy of your files on hand in case anything happens to the 
Originals. It is a good idea to back-up frequently. At some 
point (like when you've worked for days on a deadline project and 
then accidently erased your entire file), you will be very glad 
you did. 
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Making a back-up is simple. First obtain a user disk and 
label it "BACK-UP". Make sure there is a silver "Write Protect" 
tab on the notch in the disk (see Figure 1). 


If you removed your System Disk to make a hard copy, put it 
back into Drive 0 and Bootstrap. The "%" prompt should be 
present. Put your back-up disk into Drive 2. If you can give 
the Initialize command without the computer responding with an 
"Error C4" message, your user disk is formatted, therefore it is 
usable. If you can't initialize without receiving an error 
message, type: 


%FORMAT D=2 ---> 
DISK ID: BACKUP 
READY? Y 


Wait until the red lights on the disk release bars are out and 
the "$" prompt is present before continuing. 


You are now ready to move a copy of the Aphorisms file to 
the back-up disk. Type the following command, making sure not to 
leave out the comma: 


SMOVE, ---> 
% 


Remove the System Disk and put the disk with your Aphorisms file 
into Drive 0. Tell the computer to copy your file by typing: 


%X * S=0 D=2 APHORISMS ---> 
X * S=0 D=2 APHORISMS 


FILENAME DRIVE 
APHORISMS 0 
% 


S stands for source, and D stands for destination. If your 
system gave a "Destination Device Not Ready" message, you 
probably have a ZDS system and didn't change "D=2 to "D=1". 


When the red lights stop flashing and the prompt sign 
appears, the file has been copied. Put the System Disk back into 
Drive 0 and the disk with the Aphorisms file back into Drive 2. 
Don't forget to Initialize. 


There is also a way to copy an entire disk if you wish. 
This is covered later in Section 4. 
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SECTION 3 


USING THE RIO TEXT EDITOR 


3.1 Introduction 
In this section you will modify your APHORISMS file and see 
first-hand how the RIO Editor works. If you make a mistake, 


finish reading the subsection you're in. This should help clear 
up what to do to fix the mistake. 


3.2 Getting into Edit 


To get back into your APHORISMS file in the Edit mode, type: 


SEDIT APHORISMS ---> 
EDIT 1./6 
> 


Compare this with the interaction with the computer when a new 
file was created. Since APHORISIMS already exists, the system 
does not inform you that it is a new file, nor does it 
automatically put you in Input mode. Note that you must be 
editing a file before you can get into Input mode. If a "%" 
prompt is present, you cannot get into Input without first 
specifying the file you wish to input text to. 


3.3 Locating a String: The "L" Command 

If you wish to locate a specific part of your text, you can 
use the Locate command by typing an "L", followed by the string 
you wish to find. A string is a sequence of characters set aside 


by some separator. This document usually uses slash marks as 
string separators. 


As an example, locate “Every cloud has a silver lining." 
Type: 


>L, feloud/ ——-—> 
Every cloud has a silver lining. 
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The computer searches the Aphorisms file from its current 
location downward, until it comes to the first occurrence of what 
is contained within the slash marks. Since you just started this 
editing session, the current location of the Editor (before you 
gave the Locate command) was the top of the file, or the first 
line of the first page. 


When giving the Locate command, use strings that are unique 
(in this case, "cloud"); otherwise, your search will be 
inefficient, as RIO stops at the first occurrence of the desired 
string. If there are many occurrences of the given string, you 
might have to repeat the command several times before you find 
the desired line. 


The computer will locate only exactly what you ask it to 
locate. If the computer responds with "EOF", it is at the end of 
the file, and hasn't found your string. If so, type "T" and 
Carriage return, then try again. Make sure you haven't added an 
extra space, misspelled something, or capitalized when you 
shouldn't have. 


3.4 Making a Change: The "°C" Command 

The Change command instructs RIO to change what is contained 
within one set of string separators to that which is contained 
within the next set -- C /change this/to this/. Make sure to 
leave a space after the "C". 


The following line should be on your console: 


Every cloud has a silver lining. 
> 


Change this line by typing: 


>C /cloud/Rolls Royce/ ---> 
Every Rolls Royce has a silver lining. 


Note that you can use the Change command to delete a string. 
Do this by not specifying anything between the last set of 
separators. For example, if you want to delete the word "Royce", 
you could type "C / Royce//". 
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3.5 Locating a String: The "P" and "U0" Command 


There is more than one way to locate a string. This time 
you will locate "gathers no moss", but by using the Print and Up 
commands. 


The Print command writes a specified number of lines on the 
console, starting from the current line. Because you are 
approximately five lines from "gathers no moss", type: 


>P 5 --=> 
Every Rolls Royce has a silver lining. 


A rolling stone 
gathers no moss. 


> 


Note that your current line, (the line above the ">" 
prompt), is a blank line, and the line you are looking for is the 
line above your current line. Use the Up command to get there by 


typing: 


>U 1 ---> 
gathers no moss. 


3.6 Replacing a Line: The "R"™ Command 


To change an entire line, it is easier to use the Replace 
command than the Change command. Typing "R new line" will delete 
your current line, and replace it with the specified new line. 


Type: 


>R must stop sometime. ---> 
2 


Now “gathers no moss" has been deleted, and "must stop sometime" 
has taken its place. 


If you wish to replace a single line with more than one 
line, type "R", followed by a carriage return. The Editor will 
put you into Input mode, and replace your current line with 
everything you type while in Input mode. 


As an example, to put "Into each life a little rain must 
fall" on two lines, first locate the aphorism: 


>U 5 ---> 
Into each life a little rain must fall. 
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Replace this with 2 lines: 
>R ---> 
Input 
Into each life 
a little rain must fall. 


Give two carriage returns to get out of Input and back in Edit. 


3.7 Locating a String: The “°T" and "N" Commands 

If you wish to locate the first aphorism (A penny saved...-), 
you can't use "L" or "P" because these commands only work 
downward from your current line. You could use the Up command, 


but since you know you're going to the top of the file, its 
easiest to use the Top command. 


Type: 


Dt tim > 
T> 


and you'll be at the top of the file. 


If you want to see the next line, use the Next command by 
typing: 


TPN <---> 
A penny saved 


The following line is where the next change is to be made, so 
give the Next command again. 


The line "is a penny earned" should now be on your console. 
Change this to "doesn't add up to much" using the Replace 
command: 


>R doesn’t add up to much. ---> 
> 


Note: If you specify a number after "N" the Editor will execute 
"Next" that many times, but will only print the current 
line after completion. 


3.8 Deleting Text: The "DE" Command 


Locate, using any method you wish, "A stitch in time saves 
nine." 


318 


To get rid of this aphorism, use the Delete command. Make 
sure the line you wish deleted is above your ">" prompt, and 
types 


>DE ---> 


The aphorism is deleted and the Editor automatically closes 
up the blank line where the aphorism was. 


If you wish to erase more text, simply specify the number of 
lines to delete, e.g., to delete 4 lines, type DE 4. 


If you specify a string after DE, the editor will delete all 
lines down to, but not including, the first line containing that 
string. For example, if you later wish to delete all the 
aphorisms but the last one, you could go to the top of the file 
and type "DE /horse/". 


3.9 Locating a String: The "B" Command 


The Bottom command is another method of line location. To 
get to the bottom of the file, type: 


>B ---> 
but you can't make it drink. 


If you get a blank line instead of "but you can't make it 
drink," you added a few carriage returns at the end when 
originally inputting the file. If so, use the Up command (Up 
/but/), and the line will appear. Note that Up is like DElete, 
in that you can specify a string that you wish to reach instead 
of a number of times to repeat the command. This is true of Next 
and Print as well. 


3.10 Adding Text: The "I" Command 


To insert text after your current line, you must get into 
Input. Add to your file the line, "(It probably will, though)", 
by typing: 


>I ---> 
INPUT 
(It probably will, though). 


Exit Input with two carriage returns. Remember to enter 


Input only when you are at the place in your file where 
you want text inserted. 
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3-11 Routine Editing Session Wrap up 
1. Get out of Edit using the QUIT command. 
2. Back-up the APHORISMS file. 
3. Make a hard copy if a printer is available. 


The end results of all your editing efforts should look like 
this: 


A penny saved 
doesn't add up to much. 


Into each life 
a little rain must fall. 


Every Rolls Royce has a silver lining. 


A rolling stone 
must stop sometime. 


You can lead a horse to water, 
but you can't make it drink. 
(It probably will, though). 


Any time you are in Edit, you can see what your file looks 
like by going to the top of the file (type "T", carriage return), 
and using the Print command to print out any number of lines. 
Typing "P *" will print the entire file, starting from your 
current line, on the console. 


If your aphorisms file looks drastically different than the 


file listed above, change it, add to it, delete from it, etc., 
until it matches. See Section 3.12, Summary, for assistance. 
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3.12 Summary 


There is more to the RIO Text Editor, but the commands you 
know now are enough to start with. Here is a summary of what you 
have learned so far for easy reference: 


- 1_AbI ere 


B 
C fold string/new string/ 


DE 
DE # 


DE /string/ 


e 


/string/ 


N /string/ 


P /string/ 


QUIT 


What it Does 
Gets you to the bottom of the 
file 


Changes old string to new 
string 


Deletes current line 

Deletes specified number of lines 
Deletes up to, but not including, 
the first line with the specified 
string 


Puts you in Input mode so that 
you may add text to your file. 


Locates the first occurence 
(after your current line) of 
the specified string 

Goes to the next line 

Locates the line the specified 
number of lines below your 
current point in the file 
Locates the next line with the 
specified string (same as 

L /string/) 

Prints your current line 


Prints the specified number 
of lines. 


Prints all lines down through 
the specified string 


Gets you out of Edit 
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U /string/ 
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What it Does 

Puts you in Input mode 
and replaces the current 
line with all text 
given while in Input 


Replaces current line with 
the given line 


Gets you to the top of the file 
Goes up one line 


Goes up specified number of 
lines 


Goes up to the specified string 


SECTION 4 
DISK AND FILE KNOW-HOW 


4.1 Pormatting a New Disk 


Every disk must be formatted before it can be used. In most 
cases, the disk to be formatted should have a silver tab placed 
over the notch (see Figure 1). Put a tab on the disk unless 
otherwise specified. This tab should cover the front and back of 
the notch. Its purpose is to let you write on the disk via the 
keyboard. 


Put a System Disk into Drive 0 and bootstrap if the "3" 
prompt is not present. 


If you are formatting a System Disk, type: 
SFORMAT S ---> 


DRIVE: 2 (At this point, insert disk 

to be formatted into Drive 2) 
DISK ID: Egret ---—> (Give it any name you like) 
READY ?Y 


It is important to type "S" after "Format". This directs 
special System Disk information to its proper place on the disk. 


When the computer issues a prompt, the disk is formatted. 
Now move all the programs from the Master System Disk in Drive 0 
to the disk in Drive 2 by typing: 
SMOVE P=& ---> 


When the red lights stop flashing and the prompt appears, you may 
remove and label the disk in Drive 2. 


The procedure for formatting a User Disk is much the same, 
but even easier: 


SPORMAT ---> 


Drive: 2 (Insert disk to be 
formatted) 

Disk ID: Heron ---> (Can be any name) 

Ready ?¥ 


When the lights stop flashing and the prompt appears, you 
May remove the disk and label it. Don't type "S" after "Format" 
Or give the Move Command, as this is only necessary for System 
Disks. 
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4.2 Copying a Disk 


To make a copy of an entire disk, put the System Disk into 
Drive 0, bootstrap if the "$" is not present, and type: 


%COPY.DISK ---> 
DRIVES READY? 


Before continuing, remove the System Disk. Note that this 
is a safe exception to the rule about removing disks when the "gn 
prompt is not present. Put the disk you want to copy from into 
Drive 0, the disk you want to copy to into Drive 2, and continue: 


Drives Ready?Y¥ 


VERIFICATION COMPLETE 
% 


If any errors are listed on your console, it could mean that 
the disk you used in Drive 2 was bad, or that some minor 
electrical mishap occurred during copying. Try again. 


4.3 Copying a File 


The procedure for copying a file is the same as the 
procedure you used to create a back-up disk. 


Type: 


Move, —-—-> 
% 


Remove the System Disk. Insert the disk with the file you 
wish to copy into Drive 2. Insert the disk you wish to copy the 
file onto, into Drive 0, and continue: 

%X * S=2 D=0 Yourfile ---> 
FILENAME DRIVE 
2 


YOURFILE 
% 


If you want to copy more than one file, you can list them 
all at once, leaving a space between each name: 


%X * FILE 1 FILE 2 FILE 3 ---> 


If you leave out "S=2" and "D=0" in this command, the computer 
assumes your source is Drive 2 and destination is Drive 0. 
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4.4 Listing the Directory of Files 
To see what files are on the disk in Drive 2, type: 
CAT D=2 ---> 
D=2 means "list the contents of Drive 2 only." 
To see what files are on the disk in Drive 0, type: 
SCAT D=0 P=& ---> 


P=& means "properties equals anything". The system will list 
everything on the disk in Drive 0, including the special programs 
it contains if it is a System Disk. 


4.5 Deleting a File 


List the directory for Drive 2 and decide which file or 
files you want deleted. Now type "DELETE", followed by a list of 
the file(s) you want erased. For example, to delete three files 
called TRASH, JUNK and GARBAGE, you'd type: 


SDELETE TRASH JUNK GARBAGE ---—> 
DELETE 2/JUNK (Y/N/A/Q) ? 


The computer's question is to make sure you don't accidently 
delete a desired file. You should give one of the listed answers 
-- Y,N,A or Q. "Y" means yes; "N" means no; "A" means all 
(delete all of the files listed and don't ask me again); and "Q" 
means quit (don't delete any files and stop the whole procedure). 
If you type "Y" or "N", the computer will ask you one by one 
whether you want a file deleted. 


In the above example, RIO didn't forget the TRASH file. The 
computer deletes a series of files in the order that they were 
created, as opposed to the order in which you specify them. 
Therefore, JUNK must have been created before TRASH. 
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SECTION 5 


GOOD THINGS TO KNOW 


5.1 RIO Editor Command Summary 


Because the purpose of this document has been to give a 
quick overview of RIO, some unnecessary (but convenient) commands 
and options have been left out. The following is a complete list 
of RIO Editor Commands: 


Again Macro 
Bottom Next 
Brief Print 
Change PUt 
DElete PUTD 
Find QUIT 
GEt Replace 
Goto Top 
Input Up 
Join Verify 
LIneno Window 
Locate Xecute 


The RIO Text Editor User's Manual, which describes these 
commands in detail, may be obtained from Zilog. See Section 7 


for details. 


5.2 Command Abbreviations 


In the Command Summary above, some commands have only the 
first letter capitalized, while others have two or more. The 
capitalized letters indicate the minimum set of letters necessary 
to make the command, e.g., to use the Replace Command, only an 
"R" is necessary, while to use the DElete command, DE is 
necessary. If you wish, you can always use more letters. 


While in Edit, 


(when the ">" prompt is present), you may 


give commands in lower case. This is not true outside of Edit 
mode; the "$" prompt requires capitalized commands. 


5.3 * Option 


The DElete, Next, Print, and Up commands can be issued with 
a number to specify the number of times to execute the command. 
If no number is specified, 1 is assumed. This is the "default 
value". An asterisk (*) can be used in place of a number to mean 
"as many times as possible". For example, "DE *" would delete 
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all the lines from the current one to the end of the file, and "P 
*" means "print all lines until the end of the file". 


The * option also occurs in the change command. If you wish 
to change all remaining occurrences of String 1 to String 2, type 
"C /string 1/string 2/* *". See the RIO Text Editor User's 
Manual for more details of the change command, other commands 
with the * option, and other uses of *. 


5.4 String Delimiters 


This manual uses slash marks for string delimiters. 
Occasionally, however, you will need to change a string that 
contains a slash, e.g., change "in/out" to "out/in". Whenever a 
string is specified, the Editor considers the first non-numeric, 
non-blank character as the string delimiter. Therefore, to make 


the above change, pick one of your favorite symbols -- how about 
$ -- and use it where you would normally use a slash: 

C $in/out$out/in$ ---> 

out/in 


Note also that the last string delimiter in a command is 
optional. As an example, the above command can also be typed as 
"C Sin/fout$Sout/in". "L /horse/" can be written in short-cut form 
as "L /horse", etc. 
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PREFACE 


This manual describes how to use the 28000 PLZ/ASM language 
translator (Z8000ASM). The 28000 PLZ/ASM language is described 
in the Z8000/PLZ2/ASM Assembly Language Programming Manual. 
Implementation dependent features are described in this document. 


Z8000ASM depends on certain features of the RIO Operating 
System and runs on either an MCZ or ZDS system with 64K of 
memory. A complete description of the features in RIO can be 
found in the RIO Operating System User's Manual. 2Z8000ASM uses 
the stream I/O package to deal with files, and thus indirectly 
requires the memory management provided by RIO. 
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SECTION 1 


INTRODUCTION 


The RIO Editor should be used to create a 28000 PLZ/ASM 
source program. The source file should end with tne file name 
extension ".S" (upper or lower case). 


The assembler creates a listing file (with default name of 
the source file except with the extension ".L" rather than ".S"), 
and an object file (with default extension ".OBJ"). In creating 
the object file, Z8000ASM uses a temporary intermediate file that 
is deleted when the assembly is finished. The listing file 
contains both the source with line numbers and any error numbers 
on a line following the corresponding source line. The list of 
error numbers in Section 7 can be used to determine the 
corresponding assembly error. 
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SECTION 2 


Z8000ASM COMMAND LINE 


In the following description, the word "filename" is used to 
specify either a RIO file name or a RIO file name fully or 
Partially qualified by a device name. 


The assembler is invoked by the following general RIO 
command line: 


Z8000ASM filename [options] 


where filename has the extension ".S" and contains the source for 
a Single 28000 PLZ/ASM module. The extension is optional; if 
".S" is omitted, the assembler appends an ".S" before attempting 
to open the file. The following options are valid and may appear 
in any order separated by delimiters such as blank or tab. 


D=string Where "String" is at most 18 characters (not in- 
cluding delimiters such as blank, tab, return or 
semicolon) and is typically the date included in 
the heading of the listing. 


I=filename Causes the intermediate file to be named "file- 
name" instead of the default of a scratch file. 
The file may not be deleted upon completion. 


L=filename Causes the listing file to be named "filename" 
instead of the default of the source file name 
with the extension ".L". 


NOL Suppresses the generation of a list file. 

O=filename Causes the object file to be named "filename" 
instead of the default of the source file name 
with the extension ".OBJ". TE one: ‘object 2s 


desired, use S$NULL for "filename". 


P The Print option causes a copy of the listing to 
be routed to SYSLST and no compilation errors to 
be printed on the console. The default is that 
error numbers and the source line where the 
errors are detected are routed to CONOUT in 
addition to the listing file. 
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The assembler uses the following logical units for I/O: 


2 (CONOUT) Messages to the console 

3 (SYSLST) Copy of listing if P option is specified 
Source file 

Listing file 

Object file 

Intermediate file 


NADU S 
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SECTION 3 


LISTING FORMAT 


The Assembler produces a listing of the source program along 
with generated object code. The various fields in the listing 


format are described below. Refer also to the sample listing in 
this section. 


Heading The first page heading contains the Assembler 
version number and column headings as explained 
below. In addition, the heading may contain a 
user-specified string that is usually the date of 
assembly (see Date option). 


LOC Location: This column contains the value of the 
reference counter for statements. Note that the 
counter starts “at “zero for each different 
section. 


OBJ CODE Object code: This column contains the value of 
generated object code. TE oS. blanket oa 
statement does not generate object code. 


Each byte or word of object code is followed by 
either a Single quote ('), an asterisk (*) or a 
blank. aA singlle quote -4(") indieates that the 
value will be relocated. An asterisk (*) 
indicates that the value is dependent on an 
external symbol. A blank indicates that the 
value will not change. A value that is either to 
be relocated or that is dependent on an external 
is likely to be modified by either the Linker or 
loader. The value in the listing may be 
different than the value during program 
execution. Three dots "..." are used to indicate 
that the preceding byte, word or long word is 
repeated (only in data initialization). 


STMT Statement number: This column contains the se- 
quence number of each source line. 


SOURCE The remainder of the line contains the source 
text. 


335 


Z8000ASM 0.45 
LOC OBJ CODE 
0000 

0000 

0000 4c05 0000' 
0004 0000 

0006 8D18 

0008 8BO0l 

OOOA 5E07 0012! 
OOOE 5E08 0038' 
0012 A112 

0014 A921 

0016 6114 0000* 
OO1A 6126 0000* 
OOiE 8B64 

0020 5E03 0032? 
0024 4c05 0000' 
0028 0101 

002A 6F16 0000* 
OO2E 6F24 0000* 
0032 A911 

0034 5E08 0008! 
0038 4c01 0000! 
003c 0000 

OO3E SEOE 0044! 
0042 9E08 

0044 5£08 0000 
0048 

6048 

0048 2100 0012 
4C 5F00 0000' 
0050 9E08 

* EOF 
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STMT 


WOOINDO PwWrwoH 


10 
sts 
12 
13 
14 
15 
16 
17 


18 
19 
20 
21 


22 
23 
24 
25 
26 
27 
28 


29 
30 
Eial 
32 
33 
34 
35 


36 


37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 


SOURCE STATEMENT 


bubble sort MODULE 


CONSTANT 
false :=0 
true :=1 

EXTERNAL 


list ARRAY [10 WORD] 


INTERNAL 
switch BYTE 


sort 
PROCEDURE 
ENTRY 
DO 
LDB switch, #false 


CLR RI 
DO 
CP Ri, RO 
IF UGE THEN EXIT FI 


LD R2, R1 
INC R2, #2 
LD R4, list (R1) 
LD R6, list (R2) 
CP R4, R6 
IF UGT THEN 
LDB switch, #true 


LD list(R1), R6 
LD list(R2), R4 


OD 
CPB switch, #false 


IF EQ THEN RET FI 


OD 
END sort 


GLOBAL 
main 
PROCEDURE 
ENTRY 
LD RO, #9*2 


CALL sort 
RET 
END main 


END bubble sort 


1 


Pi ee 


Module declaration 


Constant declaration 


Loop control switch 


Procedure declaration 
Begin executable part 


Initialize switch 


Clear array pointer i 


Done ? ! 


1 


Initialize pointer j ! 


j = itl (dble for words) 


Li isena | > Listy] 


exchange to bubble 


largest to top of 


array ! 


Advance pointer 


for words ! 


(double) 


End nested DO loop ! 


Test switch ! 


End outer DO loop 


End of procedure 


New procedure declaration 


Program entry procedure 


Initialize loop control 


Double for word array ! 


Call sort procedure 


End of main procedure 


End of module 


SECTION 4 


LISTING CONTROL 


The assembler directive $LISTON is used to test the value of 
its operand and, depending on the result, inhibit listing of 
subsequent statements until another SLISTON directive is 
encountered. 


SLISTON [constant_expression] 


The assembler evaluates the expression in the operand field 
of the $LISTON directive. If the 32-bit result is true 
(non-zero), the $LISTON directive is ignored and subsequent 
Statements are listed normally. If the result is false (zero), 
the listing of subsequent statements is inhibited until another 
S$LISTON directive is encountered. If no argument is given, the 
directive is treated as if a true expression were specified. 


Conditional listing blocks cannot be nested; the occurrence 
of a $LISTON with no operand causes resumption of listing of 
subsequent statements. 


EXAMPLES: 
Directive Argument 
SLISTON FLAG 


!these statements are 
listed only if the value 
of FLAG is not equal to 
zero! 


$LISTON 
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SECTION 5 


CONDITIONAL ASSEMBLY 


Conditional assembly allows the programmer to inhibit the 
assembly of portions of the source text provided certain 
conditions are satisfied. Conditional assembly is particularly 
useful when a program requires similar code sequences for 
Slightly different applications. 


Rather than generating a multitude of programs to handle 
each application, the application-dependent sections of code can 
be enclosed by the conditional pseudo-ops within a_ single 
program. By changing the values of several symbols used to 
control the conditional assembly, the user can generate different 
object modules from subsequent assemblies of the same source. 


The assembler commands that allow conditional assembly are 
not currently implemented. 
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SECTION 6 


IMPLEMENTATION FEATURES AND LIMITATIONS 


Conditional assembly is not implemented in this release of 
Z8000ASM. 


The Z8000 PLZ/ASM assembler uses the standard ASCII character 
set. Upper or lower case characters are recognized and 
treated as different characters; keywords will be recognized 
only if they are either, all upper or all lower case (e.g., 
GLOBAL or global, but not Global). Hexadecimal numbers and 
special string characters can be either case (e.g., %Ab, ‘lst 
lineSR2nd lineSr'). 


Source lines longer than 132 characters are accepted but only 
132 characters are printed when printing out error messages. 
Note that comments and quoted strings may extend over an 
arbitrary number of lines, and caution should be exercised to 
avoid mismatched comment delimiters (!) or string delimiters 


(*)ss 
Strings may not be of zero Wength (e.g., °"). 


The symbol table currently contains room for approximately 
400 identifiers, depending on the length of variable names 
and the complexity of declarations (e.g., ARRAYS, RECORDs). 
Identifiers may be of any length up to a maximum of 127 
characters. 


Constants are represented internally as 32-bit unsigned 
quantities and each operand in a constant expression is 
evaluated as though it was declared to be of type LONG. For 
example, 4/2 equals 2, but 4/-2 equals 0 since -2 is 
represented as a very large unsigned number. There is no 
overflow checking during evaluation of a constant expression. 
Because constants are represented as 32-bit values, only the 
first four characters in a character sequence, used as a 
constant, are meaningful (e.g., 'ABCD' = 'ABCDE'). 


The size of an array must be specified in a declaration. 
Note that [*] is not implemented. 


When translating high-level constructs such as IF and DO 
statements, the assembler always generates JP instructions. 
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oF 


10. 


Tas 


Wie 


IES 


Because the PLZ/ASM assembler uses a recursive descent 
parsing method, the depth of nesting of constructs within a 
program is limited only by the available stack space. While 
the allocated stack space has been found to be adequate for 
all but the most contrived nesting, it is possible to modify 
the STACK SIZE value of the Z8000ASM program using the RIO 
SET command to provide more (or less) stack space when the 
assembler is executed. Refer to the RIO Operating System 
User's Manual, for further details. Stack overflow checking 
is not done by the assembler. 


Within CONSTANT, TYPE, or variable declarations, the 
assembler skips ahead until it finds the next keyword that 
will start a new statement (e.g., an opcode, IF, DO, EXIT, 
REPEAT or END). This skipping ahead may cause several 
assemblies before all errors are detected and removed. 


The initialization symbols "?", "...", and nested 


constructors ('[' and ']') are not implemented. 
Local labels ($n) are not implemented. 


Assembler directives must be typed in uppercase; e.g., 
$section will not be recognized. 


SECTION 7 


OBJECT CODE TAGS 


This section includes a list of the object tags, their 
functions and the corresponding fields used by the Z8000 
assembler. The tags are classified into three groups: control 
tags that are used to transfer control information; entry tags 
that define the code; and modifier tags that act as modifiers for 


the entry tags. 
OBJECT CODE SYNTAX 


NOTE: The object code format is still under development 
and is subject to change. 


object_module => tagged sentry* 
tagged_entry => control_entry | modified_entry 
control entry => NOP 


=> SEGMODULE size name 

=> NONSEGMODULE size name 

=> ENDMODULE 

=> SECTION size name 

=> GLOB sec loc attr typel type2 name 
=> ABSGLOB sec loc attr typel type 2 name 
=> EXTERN attr typel type2 name 

=> ENTRYPT sec loc 

=> ABSENTRYPT sec loc 

DEBUGSYMBOL bcount sec loc bval* 
DEBUGFINO bcount bval* 

MESSAGE bcount bval* 

SETDATA sec 

SETPROG sec 

BEGSEC sec 

LOCNT wval 

ABSLOCNT wval 


SOME NO NT ON, 


modified_entry => [REP bcount] [SHORT] [HIBYTE | LOBYTE] 
[SEGMENT | OFFSET] [DISP wval] 
[REL sec | RELPROG | RELDATA] 
[SEQUENCE bcount] load_entry 
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load_entry 


name 
bcount 
size 
ater 
typel 
type2 
sec 
loc 
bval 
wval 
lval 
ext 


uu uu te vue 
WAT SA SP SE ONE NAY OOO 


LDBYTE bval 
LDWORD wval 
LDLONG lval 
EXREF ext 
SECREF sec 
SECADDR sec loc 


bcount byte* 
byte 
word 
byte 
byte 
byte 
byte 
word 
byte 
word 
long 
word 


CONTROL TAGS 

HEX 

VALUE 
00 NOP 
Ol SEGMODULE 
02 NONSEGMODULE 
03 ENDMODULE 
04 SECTION 
05 GLOB 
06 ABSGLOB 
07 EXTERN 
08 ENTRYPT 
09 ABSENTRYPT 
OA DEBUGSYMBOL 
0B DEBUGINFO 
0c MESSAGE 
0D SETDATA 
OE SETPROG 
OF BEGSEC 
10 LOCNT 
11 ABSLOCNT 

ENTRY TAGS 
HEX 

VALUE 
20 LDBYTE 
21 LDWORD 
22 LDLONG 
23 EXREF 
24 SECREF 
25 SECADDR 


MODIFIER TAGS 


HEX 
VALUE 
40 REP 
41 SEQUENCE 
42 REL 
43 RELDATA 
44 RELPROG 
45 DISP 
46 *LOBYTE 
47 *HIBYTE 
48 **SHORT 
49 **OFFSET 
4A **SEGMENT 
* 28 
**78000 


OBJECT CODE TAGS 


null operation 

segmented module definition 
nonsegmented module definition 
end module 

section definition 

global symbol definition 


global symbol definition with absolute offset 


external symbol definition 
entry point with relocatable offset 
entry point with absolute offset 
debug symbol 

debug information 

variable length message 

set current data section 

set current program section 
begin section 

relocatable program counter 
absolute program counter 


load byte value 
load word value 
load long value 
external reference 
section reference 
section address 


repeat 
sequence 
relocatable 


relocatable with respect to current data area 
relocatable with respect to current program area 


displacement 

low order byte of 
high order byte of 
short segment address 
offset of 

segment of 
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SECTION 8 


PLZ/ASM ERROR MESSAGES 


EXPLANATION 
Warnings 


Missing delimiter between tokens 
Array of zero elements 

No fields in record declaration 
Mismatched procedure names 
Mismatched module names 


Token Errors 


Decimal number too large 

Invalid operator 

Invalid special character after '$%' 
Invalid hexadecimal digit 
Character sequence of zero length 
Invalid character 

Hexadecimal number too large 


DO Loop Errors 


Unmatched 'OD' 

‘OD' expected 

Invalid repeat statement 
Invalid exit statement 
Invalid 'FROM' label 


IF Statement Errors 


Unmatched 'FI' 
'FI' expected 
'THEN' or 'CASE' expected 


Symbols Expected 


')' expected 
"(' expected 
']' expected 
'T' expected 
':=' expected 


ERROR EXPLANATION 
Undefined Names 


50 Undefined identifier 
5. Undefined procedure name 


Declaration Errors 


60 Type identifier expected 


61 Invalid module declaration 

62 Invalid declaration class 

63 Invalid use of array [*] declaration 
64 Uninitialized array [*] declaration 
65 Invalid dimension size 


66 Invalid array component type 
67 Invalid record field declaration 


Procedure Declaration Errors 
70 Invalid procedure declaration 
fall 'ENTRY' expected 
%2 Procedure name expected after 'END' 


Initialization Errors 


80 Invalid initial value 


81 Too many initialization elements for declared 
variables 
82 Invalid initialization 


83 Array [*] given single non-character sequence 
initializer 
Special Errors 

90 Invalid statement 

91 Invalid instruction 


92 Invalid operand 
93 Operand too large 


94 Relative address out of range 
95 ":" expected 
99 Multiple declaration of identifier 


Invalid Variables 


100 Invalid variable 

101 Invalid operand for '#' or 'SIZEOF' 
102 Invalid field name 

103 Subscripting of non-array variable 
104 Invalid use of '.' 
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ERROR 


110 
1a 
P12 
LIBS) 
114 
ea Eis) 


120 
ea 
122 


140 


198 
19:9 


229 
230 
Pe) lb 
234 
235 
236 
254 
25:5 


EXPLANATION 
Expression Errors 


Invalid arithmetic expression 
Invalid conditional expression 
Invalid constant expression 
Invalid select expression 
Invalid index expression 

Invalid expression in assignment 


Constant Out of Bounds 


Constant too large for 8 bits 
Constant too large for 16 bits 
Constant array index out of bounds 


Type Incompatibility 


Character sequence initializer used with array 
[*] declaration where component's base type 
is not 8 bits 


File Errors 


EOF expected 
Unexpected EOF encountered in source 


Implementation Restrictions 


Unimplemented feature 

Character sequence or identifier too long 
Compiler Symbol table overflow 

Too many initialization values 

Compiler stack overflow 

Operand too complicated 

Intermediate file error 

BUG 


28000 Linker User Guide | 


OTT 
SEK 


PREFACE 


This manual describes how to use the Zilog Linker in 
conjunction with the 28, the segmented 28000, the nonsegmented 
Z8000 and the 2-80 processors. The 28000 PLZ/ASM language 
translator is described in the 28000 PLZ/ASM Assembler User Guide 
and the Z8000 PLZ/ASM language is described in the 28000 PLZ/ASM 
Assembly Language Programming Manual. 


The Linker depends on certain features of the RIO Operating 
System and can run on either an MCZ or ZDS system with 64K of 
memory. A complete description of RIO features can be found in 
the RIO Operating Systems User's Manual. 
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SECTION 1 


OVERVIEW 


1.1 Introduction 


The Linker is a general-purpose programming tool intended 
for use with several Zilog processors: in particular, the 28, the 
segmented 28000, the nonsegmented 28000, and the 2-80. The 
Linker is general enough to handle the differing architectures of 
these processors, yet includes enough capabilities to allow the 
user to configure his program as desired. 


The Linker accepts several object modules produced by an 
assembler or compiler and combines them into a single load 
module. The output of an assembler or compiler is an object 
module containing enough information to allow the Linker to 
assign that module to a memory area. Because many modules may be 
loaded together to form a complete program, inter-module 
communication is needed. For example, one module may contain a 
call to a procedure that was assembled as part of another module 
and may be located in some arbitrary part of memory. Therefore, 
the assembler or compiler must provide information in the object 
module that allows the Linker to link inter-module references. 


There are several major advantages to using separately 
assembled or compiled modules as compared to a single program 
module: 


1) Assignment of modules to memory areas can be 
handled by the Linker rather than requiring the 
programmer to assign fixed absolute locations via 
the SABS directive; thus, modules can be 
relocated without requiring re-assembly. 


2) If errors are found in one module, only that one 
module needs to be re-assembled and then 
re-linked with the other modules. 


3) Programs can be structured into independent 
modules, coded separately and assembled, even 
though the other modules may not yet exist. This 
separation of functionality also enhances program 
Maintenance and verification. 


4) Libraries of commonly-used modules can be built, 


then linked with programs, without requiring 
their re-assembly. 
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Addresses within a program module may be either relocatable 
or absolute. The notion of "absolute" assumes that there is a 
one-to-one correspondence between the assigned address of an 
instruction within a module during assembly and the memory 
address of that instruction during program execution. Thus, a 
module whose origin is "absolute 0" will have its First 
instruction located at memory location 0. 


"Relocation" refers to the ability to assign a program 
module and its data to a particular memory area at a time after 
the assembly or compilation process. The Linker program is used 
to combine and relocate several object modules into a single load 
module, while a loader program is used to relocate and load a 
single load module into specific memory addresses. 


The notion of "relocatable" assumes that the assigned 
address of an instruction within a module during assembly is a 
relative offset from an origin that is assigned an absolute 
address by the Linker and loader. During program execution, the 
instruction is located at the memory location specified by the 
assigned origin plus the relative offset. Thus, a _ relocatable 
module whose first instruction (which is located at "relocatable 
0") will have that instruction located at the memory location 
that is the assigned origin of the module as determined by the 
Linker and loader. 


1.2 Functions and Features 


The Linker performs the following functions: 1) It combines 
separately assembled modules, resolving external references; 2) 
it provides an optional link map showing how modules and sections 
have been relocated and where global variables are located; 3) it 
reports errors in the linking process to the user via the console 
and the link map. 


Linker object module input and load module output have the 
same format. This allows the Linker to be used "incrementally", 
whereby a group of modules can be combined and the resulting load 
module can be used as an object module; i.e., as input to another 
execution of the Linker. 


One of the important features of the Linker is the 
versatility it allows in arranging program and data. The PLZ/ASM 
assembly language programmer is given the option of partitioning 
code into named "Sections", discussed in detail in Section 3. 
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SECTION 2 


LOAD MODULE 


The output from the Linker, called the load module, will be 
processed by a loader when the user wishes to execute the 
program. The form of the file is similar to the object files 
generated by the assembler. One advantage to keeping the 
structure the same is that simple programs (i.e., those without 
external references) may be processed by the loader without first 
being processd by the Linker. Moreover, keeping the file 
structure consistent between the Linker and assembler aids in the 
portability of the output files between these translators. 


The structure of the load module is easily extendable. 
Future versions of the Linker can include more complex processing 
without making previously defined load modules’ invalid. Note 
that the load module is, in fact, an object module. The output 
from the Linker may be considered as any other object module and 
may be further linked in subsequent usage of the Linker. 


The load module consists of control information, called 
tags, followed by the actual values to be loaded. The tags 
indicate relocatability, address structure, messages, etc. This 
file is processed sequentially. For a listing of these tags, see 
Appendix B. Note that the format is still under development = and 
subject to change. 
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SECTION 3 


SECTIONS 


The PROCEDURE and MODULE constructs are the primary means of 
Organizing code. In addition, a PLZ/ASM assembler directive 
allows the programmer to partition pieces of code into named 
sections. A group of procedures or a certain set of data may 
belong to a single, user-named section. By default, an assembler 
Or compiler separates a module into the sections "MODULENAME P" 
(for PROGRAM) and "MODULENAME p" (for DATA). Such Partitioning 
can aid the programmer in debugging and in understanding complex 
Programs, and may be used to control the final mapping of program 
and data into memory. This user-control is useful when mapping 
code into different segments in the segmented 28000, or when it 
is desirable to physically separate the code for the procedures 
from the data ina System where read-only memory is used for the 
Procedures and read/write memory is used for the data. 


The Linker preserves the notion of sections in the load 
module. Each unique section will be Mapped into a different 
"area" of memory. For the purposes of the segmented Z8000, an 
area may be a segment. An area in the nonsegmented 28000 or the 
Z-80 is a contiguous portion of memory. In the Z8, an area is a 
contiguous set of memory locations in one of the three available 
address spaces: program, data or register. The user may combine 
sections named in his code into a Single section at link time. 
For example, sections from different modules that logically 
belong together, such as data sections, can be loaded into memory 
in an arbitrary segment or at an arbitrary memory location, but 
remain separated from other such sections. 


The concept of sections encourages the user to organize his 
program into areas and not depend on absolute memory locations. 
This allows for greater portability of code. It also encourages 
development of code that does not depend on being loaded into 
absolute memory locations or expect other code to reside at 
absolute memory locations. 
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SECTION 4 


LINKER OPERATION 


4.1 Execution 
The Linker is executed by typing the following command: 
LINKZ8000 command line 


The command line, explained in detail in Section 4.2, 
consists of the names of the input files to be processed and the 
Linker options. Any errors found in the command line result in 
an immediate abort of the Linker. The command line syntax is 
detailed in Appendix A. The user may cause the Linker to abort 
at any time by hitting the ESCAPE key. 


The Linker produces an output file, called the load module. 
This process occurs in two passes. During the first pass, the 
modules are broken up into their sections, and sections with the 
same name are grouped together. This grouping may involve 
sections in distinct modules. The Linker opens a temporary file 
to contain this reorganized code. A directory containing the 
global symbols and their locations is also built during the first 
pass. Any missing input files or input files containing 
erroneous object code will suppress the creation of the load 
module. A description of the object code format appears in 
Appendix B. 


The second pass of the Linker organizes the sections as 
specified by the user and resolves external references. Any 
unsatisfied externals sends a warning to the user. Currently, an’ 
unsatisfied external that is referenced causes a default value to 
be placed in the object module for that address. Ina subsequent 
release, any unsatisfied external references will remain in the 
load module so that the resulting "partially linked" load module 
can be used “in another linkage. 


All errors or warnings occurring during the link process 
cause a message to be sent to the console. If a link map is 
requested, all error messages will appear there as well. All 
possible error messages and explanations are listed in Section 6. 
If no errors occur during the link process, the load module is 
created. If requested, the link map will also be made. An 
example of a link map is shown in Appendix C. 
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4.2 Command Line 


The notation and options that can appear in the command line 
of the Linker are listed below. The ordering or placement of the 
Linker options within the command line is free-format. Each item 
in the command line must be Separated using one or more spaces, 
tabs, commas or linefeeds. The command line is terminated by a 
Carriage return or a semicolon. 


All object files to be used for linking must be specified by 
name in the command line. The order in which they are specified 
indicates the order in which they are processed by the Linker. 
The file names need not appear before the options or section 
information; i.e., they may be intermixed. Object file names are 
assumed to have the extension ".oBg" (Or “Joby” 1£ the first 
character of the filename is lowercase). If this extension is 
not specified in the command line, it will be added to the file 
name by the Linker. 


EXAMPLE: 
LINKZ8000 MAINPROGRAM PASSONE PASSTWO.OBJ 


Sections may be logically grouped using parentheses. For 
user-named sections PROCESS ONE, DATA_ONE and GENERATE ONE, a 
grouping would look like: 


EXAMPLE: 
(PROCESS ONE DATA ONE GENERATE ONE) 


Groups of sections may be named so that they may be used as a 
Single section in later linkages. 


EXAMPLE: 
ALL ONE = (PROCESS ONE DATA_ONE GENERATE ONE) 


To help the programmer Organize groupings easily, an 
asterisk (*) may be used in specifying section names. One or 
more asterisks may be placed within the specification of any 
section name. The Linker will look for section names’ that 
exactly match the specified portion of the name and arbitrarily 
match the star. For example, "*" would match any section name 
while "*DATA" matches MYDATA, YOURDATA, HERDATA and OURDATA. 
Using the star character, the above example may be shortened to: 


ALL_ONE = ( * ONE) 


There may be many groups in any one link operation. The 
order of the groups as specified corresponds to their order in 
memory. The order of the section names within a group denotes 
the order of the code within that area of memory. Note that 
sections in different modules with identical names are treated as 
one section. 
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4.3 Options 


The following constructs are the options the user may 
specify anywhere in the link command line. Generally, they are a 
command key word, or an abbreviated form, followed by an "=" 
character and then a file or symbol name. The key word may be 
upper or lower case, and is distinguished only by its first 
character. The file name may be replaced by a "*". This 
signifies that the default file name should be used for that 
option. 


4.3.1 Link Map 
LINKMAP = default _or file 


The default for the link process does not create a link map. 
A link map may be obtained by specifying a link map file name. A 
default name for the link map may be specified by using "*" in 
place of a file name. The default is the first object file name 
in the command line, with the extension ".MAP" appended instead 
of the ".OBJ" extension. This listing includes the modules used, 
section content and an alphabetized listing of global symbols. 
An example of a link map appears in Appendix C. 


EXAMPLE 
L = mylink.map 


4.3.2 Entry 
ENTRY = name 


An entry point may be specified in the link command line. 
The entry point is the location where execution begins. The 
default entry point is the first entry symbol encountered in the 
modules processed. Specifying an asterisk in this option is a 
null operation. 


EXAMPLE 
E = myentrypt 
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4.3.3 Load Module Name 

NAME = default or file 

The default load module name is the first file name 
specified in the command line without the ".OBJ" extension. The 
user may specify any file name by using the naming option. 
EXAMPLE 

N = MYLOADMODULE 

4.3.4 Temporary File Name 

TEMPORARYFILE = default or file 

The temporary file created by the Linker during the first 


pass of operation can be named by the user. Naming this file 
Saves the intermediate file for the user. The default name of 


this file (specified by using "™*™) is the name of the first 
object file in the command line, with the extension ".T" appended 
instead of the ".OBJ" extension. TRIGEhnis option is not 


specified, the temporary file will be created as a Scratch file, 
and will be deleted after completion of the link process. 


EXAMPLE 
T = MYTEMPFILE 


4.4 Logical Unit Definitions 


The Linker uses the following logical I/O units: 


Error messages 
Object module files 
Temporary file 

Load module file 
Link map file 


SIDS po 
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SECTION 5 


LINK OPERATION EXAMPLES 


This example shows how to link the following modules: 


Module Name File Name Sections in Module 
A A.FILE.OBJ AD 
CONTROL 
INTERFACE 


B B.FILE.OBJ BD 


Cc C.FILE.OBJ SORT 
MERGE 
SORT_D 
MERGE_D 
D D.FILE.OBJ DD 


Di. P 


The link operation to put data in one area and separate 
CONTROL code from the program code in the rest of modules iS as 
follows: 

LINKZ8000 A.FILE B.FILE C.FILE D.FILE 
( =D) 
( CONTROL ) 
( MERGE INTERFACE SORT ) 


NOTE: Each section name not specified is mapped by default into a 
separate area. 
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The configuration of the load module would look like: 


AD 

BD 

SORT_D SECTION #1 

MERGE_D 

DD 

MERGE 

INTERFACE SECTION #3 

SORT 
SECTION #4 
SECTION #5 


For the segmented Z8000, each section could be mapped to a 
segment at load time; for the 2-80, nonsegmented 28000 or the 28, 
the load module would be read into contiguous memory locations. 
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Compare the organization of the above load module with the 
following link option, where no groupings have been specified: 


LINKZ8000 A.FILE B.FILE C.FILE D.FILE 


SECTION #1 
CONTROL SECTION #2 
INTERFACE SECTION #3 
SECTION #4 


MERGE_D 


SECTION #11 
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SECTION 6 


ERROR MESSAGES 


All errors that occur in the Linker cause a message to be 
sent to the console. If requested, the message is printed in the 


link map file as well. There are three classes of error 
messages: 

Class I - Fatal 

Class II - Terminal (non-fatal) 


Class III - Warning 


Error messages and their meanings are listed below. 


CLASS I Errors 


The following errors cause an immediate abort of the Linker: 


MESSAGE MEANING 


ILLEGAL CHAR IN COMMAND LINE : <c> A character not recognized 
by the Linker was found in 
the command line. 


ERROR IN GROUPING FORMAT <symbol> An error was made in the 
command line when specify- 
ing a grouping. The symbol 
causing the error is dis- 

. played. 


OPTION NOT RECOGNIZED IN COMMAND LINE <c> 
Invalid option. The first 
letter of the option is 
displayed. 


NAME EXCEEDS MAXIMUM : <name> A filename exceeds the 
allowable length. 


UNABLE TO OPEN TEMPORARY FILE: <name> 


Unable to open temporary 
file called "name". 


UNABLE TO OPEN OBJECT FILE : <name> Unable to open output object 
file called "name". 
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MESSAGE MEANING 


UNABLE TO OPEN INPUT FILE: <name> Unable to open input file 
called "name". 


UNABLE TO OPEN LINK MAP FILE: <name> 


Unable to open link map file 
called "name". 


WRITE FILE ERROR, ERR CODE : <hexcode> 


A system error occurred while 
writing to a file. System 
error code is displayed. 


READ FILE ERROR, ERR CODE : <hexcode> 


A system error occurred while 
reading a file. System error 
code is displayed. 


SEEK ERROR, ERR CODE : <hexcode> An error occurred during 
attempt to seek to a certain 
position ina file. 

System error code is 
displayed. 


UNABLE TO CLOSE FILE <name>, ERR CODE : <hexcode> 


A system error occurred while 
trying to close file "name". 
The system error code is 
displayed. 


SYMBOL TABLE OVERF LOWED The space allocated for 
symbol information has been 
filled. How quickly the 
table is filled depends on 
the quantity and length of 
the global symbols in the 
modules linked. 


GENERAL TABLE OVERFLOWED The space allocated for 
general information about 
sections, file names, etc., 
has been filled. How quickly 
the table is filled depends 
on the number of sections in 
the modules. 
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MESSAGE MEANING 


BAD CALL TO ERROR ROUTINE <err> The internal Linker error 
routine received a call it 
could not recognize. 


FEATURE NOT IMPLEMENTED <c> An option was specified in 
the command line that has not 
been implemented yet. The 
first character of the option 
is shown. 


CLASS II Errors 


The following errors cause the Linker to abort after termination 
of the first pass: 


MESSAGE MEANING 
MULTIPLE DECLARATION OF GLOBAL: <name> <modulel> <module2> 


Global "name" defined in 
"modulel" was previously 
defined in "module2" 


NONSEG TAG IN SEG MODULE A tag relating to nonsegment- 
ed code was found in a seg- 
mented module. 


SEG TAG IN NONSEG MODULE A tag relating to segmented 
code found in a nonsegmented 
module. 

SEG AND NONSEG MODULES MIXED Segmented and nonsegmented 


modules have been encounter- 
ed during the link. 


OBJECT CODE CONTAINS ERROR <name> <id> 
The object code in file 


"name" is erroneous; "id" 
is error code. 


BYTE OVERFLOWED A relocatable byte value 
became too large for eight 
bits. 

SECTION TOO LARGE <name> The size of section "name" 


has exceeded the maximum 
size of 65,536 bytes. 
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CLASS III Errors 


The following errors cause a warning to be sent to the console: 


MESSAGE 


MEANING 


GLOBAL TYPE MISMATCH : <name> <modulel> <module2> 


UNDEFINED GLOBAL : <name> <module> 


A type mismatch for "name" 

occurred in a cross module 
reference between "modulel" 
and “module2". 


External reference "name" 
declared in "module" was not 
defined. 


REFERENCE TO UNDEFINED GLOBAL: <name> <module> 


NO ENTRY POINT FOUND 
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A reference to undefined 
global "name" was made in 
"module". 


There was no entry point 
found in the modules 
processed. 


APPENDIX A 


COMMAND LINE SYNTAX 


The syntax for the linker command line is as follows: 


LINKZ8000 options* terminator 
options => command 
=> grouping 
=> fiver list 
command => E[NTRY] '=' name 
= L[INKMAP] '='! default or file 
=> N[AME] ‘=! default or file 
=> T[EMPORARYFILE] ‘=! default or file 
grouping => [ name ‘=! ] group list 
group list => MO Ssectrone dice 
section list => name [ Separator section list ] 
file list => file name [ separator File list ] 
default or file => file name 
a a4 ea 
name => PLZ-defined section or variable name 
file name => system-defined file name 
separator => yh ee GE |) SAB 
terminator => tel | CGR 
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APPENDIX B 


OBJECT CODE SYNTAX 


NOTE: The object code format is still under development 
and is subject to change. 


object _module => 
tagged entry => 
control entry => 
=> 
=> 


=> 


modified entry => 


load_entry => 
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tagged_entry* 
control entry | modified entry 


NOP 

SEGMODULE size name 

NONSEGMODULE size name 

ENDMODULE 

SECTION size name 

GLOB sec loc attr typel type2 name 
ABSGLOB sec loc attr typel type2 name 
EXTERN attr typel type2 name 
ENTRYPT sec loc 

ABSENTRYPT sec loc 

DEBUGSYMBOL bcount sec loc bval* 
DEBUGINFO bcount bval* 

MESSAGE bcount bval* 

SETDATA sec 

SETPROG sec 

BEGSEC sec 

LOCNT wval 

ABSLOCNT wval 


[REP bcount] [SHORT] [HIBYTE | LOBYTE] 
[SEGMENT | OFFSET] [DISP wval] 

[REL sec | RELPROG | RELDATA] 
[SEQUENCE bcount] load entry 


LDBYTE bval 
LDWORD wval 
LDLONG lval 
EXREF ext 
SECREF sec 
SECADDR sec loc 


name 
bcount 
size 
attr 
typel 
type2 
sec 
loc 
bval 
wval 
lval 
ext 


bcount byte* 
byte 
word 
byte 
byte 
byte 
byte 
word 
byte 
word 
long 
word 
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OBJECT CODE TAGS 


CONTROL TAGS 


HEX 
VALUE 
00 NOP null operation 
ol SEGMODULE segmented module definition 
02 NONSEGMODULE nonsegmented module definition 
03 ENDMODULE end module 
04 SECTION section definition 
05 GLOB global symbol definition 
06 ABSGLOB global symbol definition with absolute offset 
07 EXTERN external symbol definition 
08 ENTRYPT entry point with relocatable offset 
09 ABSENTRYPT entry point with absolute offset 
OA DEBUGS YMBOL debug symbol 
0B DEBUGINFO debug information 
oc MESSAGE variable length message 
OD SETDATA set current data section 
OE SETPROG set current program section 
OF BEGSEC begin section 
10 LOCNT relocatable program counter 
11 ABSLOCNT absolute program counter 
ENTRY TAGS 
HEX 
VALUE 
20 LDBYTE load byte value 
21 LDWORD load word value 
22 LDLONG load long value 
23 EXREF external reference 
24 SECREF section reference 
25 SECADDR section address 


MODIFIER TAGS 


HEX 
VALUE 

40 REP repeat 

41 SEQUENCE sequence 

42 REL relocatable 

43 RELDATA relocatable with respect to current data area 
44 RELPROG relocatable with respect to current program area 
45 DISP displacement 

46 *LOBYTE low order byte of 

47 *HIBYTE high order byte of 

48 **SHORT short segment address 

49 **OFPFSET offset of 

4A **SEGMENT segment of 

* 28 
**78000 
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CONTROL TAGS 


NOP 
SEGMODULE 
NONSEGMODULE 
ENDMODULE 
SECTION 
GLOB 
ABSGLOB 
EXTERN 
ENTRYPT 
ABSENTRYPT 
DEBUGSYMBOL 
DEBUGINFO 
MESSAGE 
SETDATA 
SETPROG 
BEGSEC 
LOCNT 
ABSLOCNT 


ENTRY TAGS 


LDBYTE 
LDWORD 


LDLONG 
EXREF 
SECREF 
SECADDR 


MODIFIER TAGS 


REP 
SEQUENCE 
REL 
RELDATA 
RELPROG 
DISP 
*LOBYTE 
*HIBYTE 


**SHORT 
**OFFSET 
** SEGMENT 


*Z28 modules only 
**78001 modules only 


OBJECT CODE TAG FIELDS 


size 
size 


size 
sec# 
sec# 
attr 
sec# 
sec# 
beount 
bcount 
beount 
sec# 
sec# 
sec# 
wval 
wval 


bval 
wval 


lval 
ext# 
sec# 
sec# 


bcount 
bceount 
sec# 


offset 


loc attr 
loc attr 
type2 


sec# loc 


offset 


typel 
typel 


name 


name 
name 


type2 
type2 


FIELD SIZES 


name 


size 
sec# 
loc 
attr 
typel 
type2 
bval 
wval 
lval 
bcount 
ext# 
offset 


length byte, 


character string 


word 
byte 
word 
byte 
byte 
byte 
byte 
word 
long 
byte 
word 
word 
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APPENDIX C 


SAMPLE LINK MAP 


The sample link map contained herein consists of four major 
areas. The first is a copy of the command line as received by 
the linker. The second area iS a message area. It contains any 
error messages or warnings that occurred during the link process. 
In this example, "NO ENTRY POINT FOUND" is a warning to the user. 
This area also includes a message indicating the size and type of 
module produced. The third area is a mapping of sections found 
in the input modules to the sections found in the output module. 
The size and location of each input section is listed in the 
section group it is found. The section in which the module was 
found is also listed. For example, section "MERGE D" from module 
"Cc " is located in section "DATA" at 2C4. Its size is 18 bytes. 
The last area is an alphabetized listing of all globals found in 
the input modules. For each global, the location, the output 
section it is located in, and the module in which it was found 
are listed. 
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LINKER 0.1 

COMMAND LINE 

LINKZ8000 A.FILE B.FILE C.FILE D.FILE DATA=(* D) (CONTROL) 
(MERGE INTERFACE SORT) RESTP_PROGRAM=(* P) L=* 
N=MYLINKEDCODE 


NO ENTRY POINT FOUND 


NON-SEGMENTED MODULE, SIZE : 4E2 
MODULE NAMES SIZE 

0 A EE 

1 B 262 

2 eS D4 

3 D BE 


SECTION NAMES 


SIZE LOC SECTION MODULE 
332 SECTION DATA 

86 0 AD A 
1FA 86 B_D B 
44 280 SORT_D e. 
18 2c4 MERGE_D e 
56 2DC DD D 
40 SECTION 

30 0 CONTROL A 
10 30 CONTROL Cc. 
AO SECTION 

38 0 MERGE a 
38 38 INTERFACE A 
30 70 SORT G. 
DO SECTION RESTP_PROGRAM 

68 0 BP B 
68 68 DP D 
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GLOBAL SYMBOLS 


SECT LOC 


0 
0 
0 
3 
0 
3 
0 2C4 
0 
3 
0 
0 
0 
a 


NAME 


ABSOLUTELY 
COUNTER 
DELTA 
EIGHT 
FIVE 
FOUR 
HEADER 
LIST 
ONE 
REGPAIR 
SEARCH 
SORTA 
TWO 


MODULE 


Q 


QAWDNAUWPY 


Bee Ed * 


SECT 
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NAME 


BETA 

DEFINED 

DID 

EXTRA 

FOUND 

GAMMA 

KNOT 

NINE AND LAST 
esi = 
REGQUAD 
SIX_AND_SEVEN 
THREE 

VERY 


MODULE 
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4.04 


SECTION 1 


MacP DESCRIPTION 


MacP is a macro processor system designed specifically as a 
program preprocessing tool. 


MacP processing begins with a sequential scan of an input 
stream. This input stream consists of a sequence of tokens 
(defined in Section 2). If the current token denotes a special 
action, that action is performed, else the token is sent to the 
Output stream (which is another token sequence). There are two 
kinds of special actions that a token might trigger: macro calls 
and commands. 


A macro call is a sequence of tokens; the first token is a 
Macro name, and the whole sequence matches the corresponding 
Macro template. 


Matching the macro call to the template is called "parsing" 
the macro call. The parsing process uncovers the syntactic 
structure of the macro call, thereby determining the parameters 
for the macro call and the kind of repetitions or choice of 
options that are implied in the macro call. 


After parsing, macro expansion occurs. MacP scans the macro 
body associated with the invoked macro as if it were part of the 
input (inserted in place of the macro call). The macro body may 
refer to the parameters discovered during parsing. Once macro 
expansion is done (the macro body may include macro calls, so the 
Parsing-expansion process may have been executed recursively), 
the scanning of the input stream continues after the initial 
macro call. 


A command is a request for service from MacP. Commands have 
the same structure as macro calls (their syntax is defined by 
means of a macro template, and the parsing process is the same) 
but instead of an expansion, their effect is to alter the 
internal status of MacP. 

Commands allow the user to: 
e Define new macros (&let) 
e Control the scanning (&if) 
e Control the input stream (&include) 


e Organize macros in libraries and selectively choose the 
scope of a macro definition (&create, &activate, &libraries) 
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SECTION 2 


MACRO DEFINITION AND MACRO CALL PARSING 


2.1 Input Stream 


The input stream is a set of tokens; token structure is 
defined by a set of token rules known to the MacP text scanner. 
The token rules state: 


@ which byte values represent valid characters (for instance, 
the ASCII character set) 


@ which characters have special meaning (for instance, every 
command name starts with a special character, the marker) 


® how characters form tokens 


@ what to do with the string of separators between tokens 
(including comments) 


The standard set of token rules is similar to the PLZ token 
definition. This means that tokens are basically identifiers, 
numbers, special symbols and strings. 


marker =>) gs 
letter Se A al BRL. Slits tevesote' leptin 
=> a il yeDiendh feel tame aie Manker 
digit =a) ole tloch sean laowe tadae 
—— 4 5! | "6! | Hy J | "gt | 9g! 
hex digit => digit 
=> ‘At | 'B! | ta! | 'p!? | ‘gE! | 'pe 
=> Wa! | ott | Url | vqt | vey! | Let 
delimiter => ony slau 1. space 
=> tab | formfeed | linefeed 


=> carriage return 


Special_symbol => any other ASCII character 


identifier > letter 
=> identifier letter 
=> identifier ' '! 
=> identifier digit 
number => digit 


=> number digit 
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3 hex digit 


hex number => 
=> hex number hex digit 


string => 4+] 'sequence.of.characters''"' 
token => identifier 

=> number 

=> hex number 

=> string 


=> special symbol 
The construct 
ryt 


"!' any sequence of symbols not containing ! '! 


may be inserted anywhere that a delimiter may appear. 
It is called a comment and is treated as a single delimiter. 


There is an important extension: a character sequence 
enclosed in double quotes (") is treated as a single token that 
does not match any other token. Thus enclosing a sequence in 
double quotes ensures that no macro expansion will alter the 
enclosed string. 


The input stream is formed by a sequence of files. The 
sequencing is controlled by the &include command. 
2.2 Macro Definition 

A macro is defined by the '&let' command: 


macro definition => 
'slet' macro_name template '&be' body '&end' 


macro name => token 
where the "template" specifies the syntax of the macro call and 


"body" is the token sequence that will replace the macro call at 
expansion time. 
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2.3 Macro Syntax: Part I 


The set of macro calls that correspond to a given macro 
definition has a syntactic structure similar to regular 
expressions. Thus a template can be represented as: 


template => [item] * 


item => delimiter | 
parameter | 
regular expression 


A template is a (possibly empty) sequence of items; each 
item represents either a parameter, a delimiter or a more 
structured construct called a regular expression. 


When matching a template against the macro call, successive 
items are matched (according to the rules below). When the last 
item has been matched, the parsing of the macro call is 
considered successfully done. 


If at any point an item cannot be matched against the 
currently scanned token, an error message is generated. 


A delimiter is a keyword throughout a macro call; it 
delimits parameters and/or specifies the structure of regular 
expressions. 


Parsing a delimiter item means matching the currently 
scanned token with the delimiter: they must be equal. 


delimiter => token 


Once the token is matched, the parsing process advances to the 
next item in the template and the following token in the 
currently scanned input stream. 


parameter => 
'<' parameter name [balance] [environment] '>' 


parameter name => token 


A parameter is denoted by a name enclosed in angular 
brackets and represents a (possibly empty) sequence of tokens in 
the macro call. Parsing a parameter item implies successively 
scanning the input stream until a token is found that could match 
the next item in the template. In that respect parameters are 
"Match-it-all" constructs: they match anything up to whatever 
the following parameter or delimiter can match (see Appendix A, 
Parsing Complexities). 
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Parameters can, however, be structured: 
balance => [open _symbol close _ symbol] + 
open_symbol => token 
close symbol => token 
The balance of a parameter is specified by pairs of tokens: 
every instance of “close symbol" must be preceded by a matching 
occurrence of "open_symbol". This balancing process may apply to 


many pairs of symbols (with an error condition generated by 
sequences like "“(a[b)]"...). 


Whenever a parameter is being parsed, the currently scanned 
token is 


e first checked to see whether the current parameter 
should be terminated; 


e if not, the parser checks whether the token 
is a macro name, in which case it (possibly recursively) 
starts parsing the new macro call. 


To determine whether the current token iS a macro or not, 
the environment may be specified: 


environment => 'uses' [library name]+ | 
"‘uses' 'none' 


The environment tells the parser where to search for macro names: 


e if the environment is empty, search in the 
active libraries (see Section 5.3, Library Handling) 


e if the environment specifies a list of libraries, 
search those 


e if the environment states "uses none" nothing 
within the parameter will be considered a macro 


Example 1: 
&let MAC &be ... &end 


The above macro MAC defines only one macro call: the single 
token "MAC". 
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Example 2: 
&let ALPHA BETA &be ... s&end 


The macro call for the macro ALPHA is the sequence "ALPHA 
BETA". 


Example 3: 
&let do <QUESTION> . &be ... &end 


Parameters match sequences of tokens; the following are 
valid macro calls associated with the macro "do": 


do you wanna talk? OK. (<QUESTION> is 
associated with "you wanna talk? OK.") 


do MAC , (<QUESTION> = MAC) 
do’. (<QUESTION> is empty) 


Example 4: 


&let for <index> := <from> until <to> 
do <body do od> od 
&be ... end 


This macro defines an ALGOL-like for Statement, that could 
be used to extend PLZ/SYS. Note that the parameter <body> has to 
be balanced with respect to pairs "do od", so that 


"for i := lduntil/10sdo 
do something od 
od 


will correctly match <body> to the sequence "do something od" 
(otherwise, the first "od" would match the delimiter "od" in the 
Macro template, producing the unwanted parse). 


Example 5: 


&let if <exp uses expression lib> 
then <true part> else <false part> fi 
&be ... &end 


This macro defines an "if" Statement (as in PLZ). The first 
Parameter, <exp>, has as its environment the library called 
"expression lib" (presumably such a library will contain macro 
definitions that parse and generate code for the expression). 
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Example 6: 


&let Simple macro <P1> <P2> <P3>; 
&be ... &end 


The above definition corresponds to an “old fashioned" macro 
with three parameters, and delimited by a semicolon. This 
example shows what happens with contiguous parameters: <P1> 
matches the first token (or macro call), the following token is 
matched by <P2> and the rest, up to the semicolon, by <P3> (see 
Appendix A, Parsing Complexities). 
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2.4 Macro Syntax: Part II 


The previous section dealt with the simpler kinds of items 
in a template. This section covers regular expressions. 


regular expression => 
'[T' [regular_expression_ name] [separator] ':' 
choice [,*]|." echoicel*')" [count] 


regular expression name => token 
separator => token 


A regular expression is enclosed in square brackets followed 
by an optional count and consists of a set of choices. In order 
to identify the regular expression, a name is associated with it. 


choice => [item]+ 


A choice is basically a non-empty template. Each choice 
within a regular expression represents an alternative form for 
the expression. 


A regular expression also specifies a repetition: each 
instance of such repetition may take the form of any of the 
choices. 


count => tee | tet | ros 


Both the separator and the count determine the number of 
occurrences of the regular expression in the actual macro call. 


If the separator is non-null, the regular expression should 
occur at least one time; occurrences are separated by the 
separator. If the separator is null, the count determines what 
happens. The count may be one of the following, each with its 
corresponding meaning. 


de : the regular expression occurs one or more times 


1% 


the regular expression occurs zero or more times 


eT : the regular expression occurs zero or one times 
empty : the regular expression occurs one time 
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The different types of regular expressions fall into one of 
two categories: 


e those that may occur more than once (non-empty separator, or 
count being "*" or "+"); these are referred to as "repeat" 
expressions. 


@ those that may occur once at most (empty separator and count 
being empty or "?"); these are referred to as "choose" 
expressions. 


Example 1: 
&let Either [reg: Yes | No | Maybe] &be ... &end 


This is an example of a choose expression: the macro Either 
has three macro calls associated with it: 


"Either Yes" 
"Bither No" 
"Either Maybe" 


Example 2: 
&let call <proc> ( [more ,: <arg>] ) &be ... &end 


The above macro matches procedure calls with one or more 
arguments (separated by commas). The parameter <proc> will match 
the procedure name while the repeat expression "more" will stand 
for the sequence of arguments, each one matched by the parameter 
<arg>. 


Example 3: 
&let Ml [loop: <Par>]* ; &be ... &end 


The macro Ml has a variable number of parameters (each one 
an instance of the parameter <Par>); parameters consist of single 
tokens. The repeat expression "loop" may have zero or more 
instances. 


&let Read (<unit> [form:, <format>] ?) 
{read list ,: array <arg> 

| <scalar>]+ ; 

&be ... &end 
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In the case of macro Read, the first choose expression 
matches an optional <format>, while the second is a repeat 
expression (one or more instances, separated by commas) of two 
choices: either the construct "array <arg>" or a parameter 
<scalar>. 
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SECTION 3 


EXPANSION PROCESS 


3.1 Body of a Macro: Part I 


A macro body is a token sequence, with two special features 


that relate it to the corresponding macro call. 

First, parameters are denoted by the construct "<name>". 
Whenever a parameter is reached at expansion time, the 
corresponding instance of that parameter in the macro call is 
expanded. 

Example 1: 
&let MAC &be MACKINTOSH &end 
Every instance of "MAC" will be replaced by "MACKINTOSH". 
But if we had defined 
&let MACKINTOSH &be Rain Coat &end 
"MAC" would first be replaced by "MACKINTOSH" and "MACKINTOSH" 
would again expand into "Rain Coat". 


Example 2: 


&let for <index> := <from> until <to> 
do <body do od> od 


&be 
<index> := <from> 
temp s= <to> 
do 
if <index> > temp then exit fi 
<body> 
<index> := <index> +1 
od 
&end 


This macro generates the PLZ/SYS code for a "for" loop. Note t 
no check is made as to the validity of the parameters. 


hat 
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3.2 Body of a Macro: Part II 


In order to deal with regular expressions, the macro body 
must contain means to 


@® access each instance of a repeat expression 


e determine which choice has been made for each instance of 
a regular expression. 


In order to access any instance of a repeat expression, the 
user must explicitly insert a "&foreach" construct in the macro 
&foreach <repeat_name> 
&do <foreach body> &od 
where <repeat_name> is the name of a repeat expression and 
<foreach_body> is a token sequence that will be scanned once for 
each instance of the repeat expression. 


Example: 


&let invoke <proc> ([more, :<arg>]) 


&be 
&foreach more 
&do PUSH <arg> &od 
CALL <proc> 
&end 


The "&foreach more" states that the sequence "PUSH <arg>" be 
scanned once for each instance of the expression "more". 
Furthermore, each time the &foreach is repeated, <arg> is 


associated with the corresponding parameter in the macro call. 
Thus 


invoke PRINT HEX (A, X+3, R4) 
generates 

PUSH A 

PUSH X+3 


PUSH R4 
CALL PRINT HEX 
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In order to determine the choice selected for a given 
instance of a "choose" expression, the construct 


<regular_expression_ name> 


evaluates to the leading token of the current instance. 


Examples: 
The macro 


&let Either [reg: Yes | No | Maybe] 
&be 
We got 
&if &eq str (<reg>, Yes) 
&then a positive answer 
&else &if &eq _ str (<reg>, No) 
&then a negative answer 
&else no answer yet &fi 
&fi 
&end 


will output three different sequences according to the choice 


made for the expression "reg". If <reg> is "Yes" the output will 


be "a positive answer"; if <reg> is "No", "a negative answer" 


will be output; if <reg> is "Maybe", "no answer yet" will be 
Output. Note the use of the command "&if", which decides what to 
expand. 

Similarly, 


&let Read (<unit> [form:, <format>] ?) 
[read_list ,: array <ary> 
| <scalar> ]* ; 


&be 
Setup (<unit>) 
&if &isempty (<form>) 
&then Start_input (no_format) 
&else Start_input (#<format>) &fi 
&foreach read list &do 
&if &eq str (<read_ list>, array) 
&then Array input (#<ary>) 
&else Scalar_input (#<scalar>) 
&fi 
&end 
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In this case the construct <read list> within the &foreach 
refers to the leading token of the current instance of the 
expression "read list", so that 


Read (6, F_str) A, array X, C[il; 
produces the output 


Setup (6) 

Start input (#F str) 
Scalar_input (#A) 
Array input (#X) 
Scalar _input (#C[i]) 


3.3 Binding the Macro Call and the Macro Body 


When expanding a macro whose template is composed only of 
parameters, delimiters, and choose expressions, a parameter or a 
choose expression can be referred to by naming it. However, in 
the case of repeat expressions, each instance of the expression 
has associated with it a different set of instances of the items 
defined within the expression. Thus, scope rules are needed to 
allow the expansion process to access different instances of 
items in the macro call. 


"Accessing an item" within a macro body means: 


@ expand a parameter p (wherever the construct <p> 
appears) 


@ evaluate the leading token of a choose expression C 
(by means of the construct <C>) 


@ execute a "foreach r" command for a repeat expression r 
and evaluate the leading delimiter of each repetition 
(with <r>). 


The scope rules are: 


1. The items within a repeat expression r may be 
accessed only from within a "foreach r" command. 


2. The items defined within a choose expression C (except 
for those internal to any inner repeat expression) may 
be accessed wherever C is accessible. 


3. The items defined in the template of a macro (except 


for those internal to a repeat expression) are 
accessible from anywhere in the body of the macro. 
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The "foreach" construct ("&foreach r &do for _ body &od") 
associated with a repeat expression "r" can be defined as 
follows: 


1. The “foreach" may appear only where "r" is accessible 


2. All the items accessible where the "foreach" is included 
are accessible from within "for _body" 


3. The "for body" is scanned once for each repetition of the 
expression and all the items accessed are associated with 
the corresponding instances of themselves (in particular, 
the construct <r> within the "for _body" stands for the 
leading token of the current repetition). 
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SECTION 4 


ARITHMETIC: DATA STORAGE AND HANDLING 


MacP provides the user with a facility to store arithmetic 
values and evaluate expressions. The command 


&set <v> := <expression> &end 
evaluates <expression> and associates the resulting value with a 
name denoted by <v>. Further references to the token <v> within 


arithmetic expressions will yield its associated value. 


MacP expressions are similar to PLZ/SYS expressions (for 
unsigned 16-bit WORD type). The operators handled by MacP are: 


+; =, OL ;. XOX 
*> /, Mod, and 
When MacP evaluates an expression, it first evaluates the "*", 
"7", "mod", and "and" operations, then applies the "+", "-", 
"or", and "xor" operations. This procedure parallels the 
standard PLZ precedence of operators. Precedence may be altered 
by means of parentheses. 
Note that unary operators are not implemented. 
The command 


&0ut (<v>) 


outputs the value of variable <v> as a five-digit decimal string. 
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SECTION 5 


COMMANDS 


5.1 Conditional Expansion of Macros 
The command 
&if <exp> &then <textl> &else <text2> &fi 


evaluates <exp> and scans <textl> or <text2> depending on whether 
its value is true or false. 


The expression <exp> must be a call to either of the 
following three predicates: 


&isempty (<str>) true if <str> is the empty 
string; otherwise false 


&eq str (<str1>,<str2>) true if <strl> and <str2> 
are equal; otherwise false 


&isstring (<str>) false if <str> is a macro 
call; otherwise true 


Or a conditional expression of the form 
<expl> <relop> <exp2> 


where <expl> and <exp2> are arithmetic expressions and <relop> is 
one of 


ls (less than) 

le (less or equal) 

eq (equal) 

ne (not equal) 

gt (greater than) 

ge (greater or equal) 


Note: All macro commands in MacP are executed using the general 
Macro parsing mechanism. 


391 


5.2 Input Control 
The command 
&include <filename> &end 
causes the scanning of <filename> to be started. When the end- 
of-file condition is encountered, scanning of the previous file 
resumes. Nesting of &include commands is allowed up to five 
levels. 
5.3 Library Handling 
A library is a collection of macros contained in a single 
file. Because of design considerations, MacP will only handle 
libraries that contain fewer than 255 macros. 
Libraries are created by the following command: 
&create <filename> send 
All the macro definitions found after a &create command will 
be included in the file specified. The previous content of the 


file is destroyed. 


The current version of MacP is limited to 200 macros 
distributed in 32 libraries maximum. 


The command 
&libraries [C,: <lib>] &end 
declares the names given as libraries. After this command is 
issued, no more macro declarations or &create commands are 


accepted by MacP. 


Immediately after the &libraries command, MacP does not 
recognize any macro calls. The command 


&activate [C, : <lib>] &end 


causes MacP to recognize calls to all the macros included in the 
libraries specified (and only to these macros). 
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5.4 Miscellaneous Commands 
The command 

&unique 
outputs a unique string of five decimal digits, from within a 
macro expansion. The particular string remains constant 
throughout the entire expansion. For instance: 

&let do <body> od 

be 

L &unique: 


<body> 
jp L &unique 


&end 


A call like 


do 
ine, hil 
ld a (hl) 
and a 
ld (hl) a 
od 
will generate 
L01937: 
ine hl 
ld a (hl) 
and b 
id Gh); a 
jp L01937 


where the string "01937" was arbitrarily chosen and could be any 
string of five decimal digits. 


The command 
&peel [c: onloff] &end 


instructs the scanner to either discard double quotes enclosing 
strings (&peel on &end) or to leave quotes (&peel off &end). 


By default, during the first phase (library creation), 
peeling is set to "off" (so double quotes remain inside of macro 
bodies). During expansion phase, the peeling is set to "on" (so 
double quotes are not output). 
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SECTION 6 


MacP OPERATION 


MacP consists of two phases. The first phase compiles 
Macros and creates libraries. The second phase uses existing 
libraries to expand the input stream. 


Both phases or only one phase may be used in any single run 


of MacP; if both, the macro generation phase must be the first 
One. 


An example of the input stream is as follows: 
&create libl &end 


&let macll ... Definition of macros 
&let macl2 ... included in libl 


&create lib2 &end 


&let mac21 ... Definition of macros 
&let mac22 ... included in 1ib2 


&create lastlib &end 


Definitions of macros 
for lastlib 


&libraries libl, lib2, ... &end 

&expand 
!No macros are active here, so no expansion will 
occur! 

&activate libl, lib2, ... &end 


Text to be expanded using the macros in 
libraries: Wabi, Pib2,) ss 


Note that the command "&libraries" starts the expansion 
phase. Also, if existing libraries are used, the library 
creation phase does not need to be initialized. 


MacP accepts input files with the suffix .MAC or .mac. To 
invoke MacP, type to RIO the following command: 


MACP file 
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When processing a file X.MAC, MacP will produce two files: 


@ An input image file, X.M, including line 
numbers and error messages 


e The output file, X.S 


Similarly, X.mac will produce X.m and X.s, respectively. 
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APPENDIX A 


PARSING COMPLEXITIES 


This section introduces some of the ambiguous situations 
that may arise during the parsing of macro calls, and presents 
the conventions adopted to solve them. 


0 - Nested Macro Calls: during the parsing of a parameter, 
a macro name is encountered. 


Rule 0: Proceed to parse the entire macro call (recursively) 
and match the entire macro call to the parameter. 


Example: 
Given the macro 


&let if <exp> then <tpart> 
[:else <fpart>]? fi &be ... &end 


A macro call such as 
if x < 0 then x := 0 


else if x 0 then exit fi 
call interp fi 


matches 
<exp> = "x < 0" 
<tpart> = "x := 0" 
<fpart> = "if x = 0 then exit fi 
call interp" 


1 - Delimiter vs. Macro Name: during the parsing 
of a parameter, a token is encountered that is both 
a delimiter and a macro name. 

Example: 


&let Loop <index> begin <body> end 
&be ... &end 


&let end &be ... &end 
Rule 1: The token is considered a delimiter if it 
terminates the parameter; otherwise, it is 
considered a macro name. 
In the following case: 
Loop i begin A[i] := 0 end 
both "begin" and "end" are treated as delimiters. 
But in the case 
Loop i end begin A[i] := 0 end 


the first "end" will be treated as a macro call and the 
second one as a delimiter. 


397 


2 - Parameter after Parameter: 
contiguous in a template. How to match successive 
tokens in the two parameters is explained below. 


Example: 


Rule 


In the following cases: 


Note that Rule 2 also applies to 


2: 


or 
in 
in 
in 


so that 


Matches a, b and c to three instances of <p> 


&let M <pl> <p2> ; &be 


The first parameter matches one token 
and then the parse continues with the 
Parameter and the rest of the tokens. 


(1) 
(2) 
(3) 


(1) 
(2) 
(3) 


M 


M 


al a2 a3 a4 ; 
M bl; 


. 
’ 


<pl> = 
<pl> = 


both 


&let Ml 


M1 


[seq 


Also, the case 
M Ml xy; 
will match 
<pl> Ml x y 


bl 


, <p2> = 


two parameters are 


ee. &end 


a2 


a3 a4 


, <p2> is empty 


<pel* -¢ 


toktok ; 


. 
, 


and <p2> 


since Ml is a macro name. 


398 


&be 


<pl> and <p2> are empty 


e.. &end 


toktok 


(if any) 
contiguous 


3 - Macros that cannot be parsed: Given the parsing 


method used by MacP, some macro definitions cannot 
be parsed without resorting to a guess somewhere 
along the parse. MacP rejects these macros when 
processing their definition and warns the user. 


Rule 3: MacP accepts only macro templates that can 
be parsed by looking at most one token ahead. 


Examples: 
&let Mac [ch : ax | ayi]l &be ss. send 
When parsing the expression "ch", MacP must look two tokens 
ahead ("a" and the next one) in order to determine which choice 
to take. 
&let Mic [loop : <p>]* <pl> ; &be ... &end 
In the above example, there is no way to decide whether the 


next token is a new instance of the repeat expression "loop", or 
is a match for the parameter "pl". 


399 


Error 
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ai 
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23 


24 
25 


26 
27 


28 
29 


30 
31 


33 


35 
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APPENDIX B 


ERRORS 


MacP produces errors of different types: 


W (Warning) 


S (Serious) 


F (Fatal) 


An error is detected from which MacP 
can recover. The user output may not 
be correct but execution continues. 
Recovery may or may not be possible. 


No recovery is possible, MacP aborts. 


Additionally, MacP will enter a loop at a certain address 
when an undefined error occurs. If your system enters a loop, 
most likely you have found a bug in MacP. 


The following is a list of the error codes produced by MacP 
and their type. 


Type 
(F) 


(F) 
(F) 


(F) 


(S) 


Condition 


Buffer overflow (either for macro 
generation or for library's dictionary) 
Too many libraries (more than 32) 

The libraries declared in '&libraries' 
contain too many macros 

Problems in the library file (macro 
header is wrong) 

Macro name toc long (more than 32 bytes) 
Bad input file name (must end with * mac’ 
or '.MAC') 

'glibraries' command issued from within 
a macro 

Too many nested '&includes' 

Same as Error 21 

Duplicate library name in the 
'glibraries' command 


Not enough buffer space to load a macro 
Too many active macros in memory (more 
than 100) 

A library that appears in the 'uses' part 
of a parameter or the list of an 
"gsactivate' command has not been 

declared in the '&libraries' list 

Too many libraries in the list of 
‘&Sactivate' 


Error 


50 
Sill 
52 


53 
54 
57 


58 


61 
62 
63 
64 


65 
66 
67 
74 
Vie: 


76 
77 
78 


90 
91 
92 
93 


100 
101 
102 


103 
104 


120 
L2a 
122 
123 
124 
125 


Condition 


Missing parameter name 

Non-empty count required 

The name between angle brackets is not 
a parameter or a regular expression 
name 

Missing macro name 

Too many delimiters in the macro 

The name has already been declared as a 
parameter or a regular expression name 
Too many parameters and/or regular 
expressions 


No closing balance delimiter 

Too many libraries used in this macro 
Macro generation buffer overflow 

Too many items in current macro 
template 

Name is not a repeat expression: 
&foreach is ignored 

Repeat expression used in enclosing 
&foreach: &foreach is ignored. 
Unknown external procedure in ‘&call' 


Ambiguous syntax: regular expression 
may be empty 

Syntax problems in separator list: 
conflict with next item's lead 

Too many delimiters 

Balance problems 

Syntax problems in choice list: 
conflicting leads 


Parsing nesting too deep 

Parse stack overflow 

Balance pair does not match 

Syntax error (during macro call parse) 


Input buffer overflow 

Input error 

Too many nested macro 
expansions/&includes 

Too many ‘'&includes' 

I/O error when closing include file 


Evaluation stack overflow 

Boolean expression expected 

Stored values name pool overflow 
Operand name cannot be evaluated 
Too many stored values 

Undefined value (evaluates to zero) 
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Error Type Condition 


126 (F) Expression does not yield an 
arithmetic value 

127 (F) Expression is ill defined 

200 (W) Decimal number overflow 

201 (W) Hexadecimal number overflow 

202 (W) Invalid hexadecimal digit 

203 (S) Invalid character 

204 (S) Unmatched quote 

205 (S) Unmatched comment symbol ("!") 
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APPENDIX C 


I/O UNITS 


The following table lists the MacP Input/Output units and 
their usage. 


Unit Usage 

4 "&create" library output 

5 Listing 

6 Expansion output 

7 Macro loading (input) unit 
10-14 Input files (initial one is 10, 


and each nested &include is 
assigned successive units. When 
a file ends its unit is freed) 
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APPENDIX D 


OUTPUT FORMAT 


In MacP, a file with no macro calls produces an output of 
the same format. But in the case of a new macro expansion the 
output will not reflect the spacing between tokens. Therefore, 
the spacing must be explicitly specified in the macro definition. 
For instance, the macro 


Sliet M <pl> , <p2> ; &be <pl> <p2> send 
and a call like 
linel 
M John, Alfred; 
line2 
will produce the output 
linelJohnAlfredline2 
A more desirable output format might be 
linel 
John 
Alfred 


Line 2 


which is achieved using sequences of spaces, tabs and carriage 
returns enclosed in double quotes ("). 


&let M <pl> , <p2> ; &be " 
wu <A pl > " 
" " 

! <p2> 


&end 


Note: The string after &be is "<CR><TAB>" 
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SECTION 1 


INTRODUCTION 


The Z-80/Z8000 translator iS a programming tool for 
upgrading RIO Z-80 programs to the 28000 instruction set and the 
PLZ/ASM program format. 

TRANS8000 is designed to run under the RIO operating system 
on both the MCZ and ZDS systems. A minimum memory size of 48K is 
required for TRANS8000 to execute. 

The following manuals may be useful to the reader: 

® Z-80 RIO Relocating Assembler and Linker User's Manual 

e Z-80 Assembly Language Programming Manual 


e Z-80 RIO Operating System User's Manual 


Z8000 PLZ/ASM Assembly Language Programming Manual 
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SECTION 2 


TRANSLATOR STRUCTURE 


2.1 Overview 


The translation process makes two distinct passes. The 
first pass, called the Decomposition pass, converts each line of 
Z-80 ASM source to an intermediate form and symbols are entered 
into the symbol table with scope and type information. The 
second pass, called the Building pass, builds the 28000 PLZ/ASM 
source and critique files. 


The translator may be executed in either an Interactive mode 
or in a Noninteractive mode. This allows the programmer to set 
the translation options along with flag and register mappings at 
translation time. 


2.2 Decomposition Pass 


During the decomposition process, each field of a source 
line is scanned and denoted as a label, a pseudo-op, an opcode or 
an operand. Operands can be either keywords or expressions. The 
Z-80 source lines are not checked for legal assembly language 
Syntax nor for correct opcode and operand combinations. 
Decomposition processing of a line continues until a carriage 
return or a comment field is recognized. 


Many of the 2-80 opcodes are dependent upon the operand 
combination. These opcodes are fixed up after the source line 
has been processed because the equivalent 28000 instruction does 
not allow the same set of operands (usually indirect register 
addressing), or the opcode does not uniquely specify whether the 
Operation handles 8 or 16-bit quantities. 


Pseudo opcodes also need fixing to reflect their meaning. 
The "LIST" pseudo-op will be changed according to its operand. 
The "ORG" pseudo-op will be changed to either "SABS" or “SREL". 
Keywords in the decomposition process are matched with a case of 
all upper or all lower depending on the case of the first letter 
of the keyword. 


Macros are not processed during the Decomposition pass. 


Likewise, no reconstruction processing of macros is done during 
the building process. 
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Symbols in expressions are translated with the rest of the 
syntax. Most valid 2-80 operators are also valid in 28000 


PLZ/ASM expressions. Any occurrences of invalid operators cause 
a warning message to be displayed. For example, the two 2-80 
arithmetic operators "**", for exponentiation, and ".RES.", for 


overflow conditions, do not have PLZ/ASM equivalents. Also, when 
using the program counter variable, "S", in expressions, the user 
should consider that Z-80 instruction sizes are not the same for 
equivalent Z8000 instructions, and that the precedence order of 
logical and arithmetic operators is not the same. 


Because 2Z8000 PLZ/ASM handles all expressions as 32-bit 
unsigned quantities, signed greater-than and signed less-than 
Z-80 ASM operators are translated to "reasonable" PLZ/ASM 
expressions and noted in the critique file. 


2.3 Building Pass 


The translator performs two distinct functions. One is to 
take a sequence of 2Z-80 instructions and change them to a 
sequence of 28000 instructions while preserving the operational 
equivalence of the execution. The other is to convert the syntax 
of the 2Z-80 assembly language, including opcodes, operands, 
pseudo-ops, and expressions, to the syntax of the 28000 PL2/ASM 
assembly language. The first function will not be dealt with 
completely. Approximately 96% of the Z-80 instructions can be 
translated to operationally equivalent 28000 instructions. Most 
of the translations are one for one (about 80%), the rest are one 
to many. Operational equivalence means that the register values 
and flag states are left in equivalent states after the 
Operation. Operational equivalence does not imply that the 
number of bytes and the CPU time necessary to simulate the 
Operation are equal. 


The function of converting syntax is dealt with completely 
during the building pass. All opcodes, operands, pseudo-ops, and 
expressions are changed to 28000 PLZ/ASM syntax. Also, the 
line-oriented 2-80 assembly language format is fitted into the 
structured assembly language as defined by PLZ/ASM. 


Since PLZ/ASM is a structured assembly language, TRANS8000 


must put the Z-80 source program into a structured form. The 
objective is to leave instructions and declarations in the 
Original order and insert structuring information where 


appropriate. The entire program is then formed into a module. 
The module name is prefixed by the source file name with an 
" MOD" appended. Definitions are handled by appropriate 
declaration sections. All contiguous instruction lines 
(including blank, comment and assembler control lines) are 
grouped into one internal procedure. A generated procedure name, 
"PROC_nn", is assigned to satisfy the PLZ/ASM syntax. Any labels 
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appearing within that procedure are implicitly declared as 
internal unless declared elsewhere. Labels declared as global or 
external are explicitly declared as such at the original point in 
the program. A sequence of instructions broken by a data 
declaration cause the ending of the previous procedure and _ the 
Starting of a declaration section. Any subsequent instructions 
cause a new procedure to be entered and a new procedure name to 
be generated. 


Most 2-80 instructions and Z-80 ASM pseudo-ops will be 
translated to an equivalent form. The translation is done 
line-by-line to reserve ordering of code and declarations. 
There are many cases where one Z-80 instruction will generate 
several 28000 instructions, particularly if the user requires 
that the flag states remain equivalent for each line of the 
execution. Flag incompatibility and fixups are discussed in 
detail in Section 4.3. Instructions that are not translatable 
are those most directly related to the differences in CPU 
architecture. Because PLZ/ASM does not support macros, all macro 
definitions are passed through the translator unprocessed. An 
approach to solving this problem is discussed below. 


There are two problem situations that may arise for which 
the translator has no reasonable solution and must therefore be 
corrected by the user. One problem involves a small group of 
instructions that have no logical equivalant due to architectural 
differences between the Z-80 and 28000 Central Processing Units. 
The second problem involves an instruction sequence that accesses 
a memory byte logically declared as a portion of a word quantity. 
This problem occurs because the Z-80 stores word quantities in 
memory with the high and low bytes in reverse of the 28000 memory 
layout. 


Frequently in programming with the RIO 2-80 assembler, a 
Programmer would equate a label to an address constant. The 
label would then be used in a Call or Jump command in place of 


the constant. The PLZ/ASM assembler imposes stricter 
restrictions upon the use of a constant. Only constants declared 
to be labels may be used in a Call or Jump command. The 


translator will not correct, this problem for the user, but the 
user may easily fix this by editing the Z8000 source file. 
2-4 Handling Macros 


An important difference between the Z-80 ASM and 28000 
PLZ/ASM is that the latter does not support a macro capability. 


The problem of translating a program that is heavily 


dependent on the macro facility available in the Z-80 assembler 
can be handled as follows: Assemble the program creating a 
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listing file with the macros expanded, then remove the unwanted 
information (opcodes, object bytes, etc.) using the Editor. This 
new file may then be processed by the translator. 
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SECTION 3 


TRANS8000 OPERATION 


3-1 Command Line Format 
The format for the translator command line is as follows: 
TRANS8000 source-filename [options] 


The first item in the command line after the program name, 
"TRANS8000", must be the filename of the file to be translated. 
The file must have a file extension of ".S" or ".s". The given 
filename may be a fully or partially qualified RIO filename. 


All files created by TRANS8000 will consist of the given 
filename, with the ".S" removed, and the appropriate extension 
appended. The following extensions are used for the respective 
files: 


-Z8000.S => translated Z8000 PLZ/ASM source 
7eRIT => critique file 


- INT => intermediate file (temporarily created) 


Any of the above filename defaults can be overridden by the 
command line options "S=", "C=", or "I=". Directing file output 
to device SNULL causes no file to be written. 


The command line can also contain any of the directives 
listed in Section 3.3, except the "STEP", "FLAG", and "REGISTER" 
directives. 


EXAMPLE: 
STRANS8000 DEMO DISPLAY C=SNULL 


causes the file DEMO.S to be translated with the source displayed 
at the console and no critique file written. 


When the translator is invoked from RIO, an echo of the 
TRANS8000 name and the version will be displayed at the console. 
The version echo tells the user which release is being executed, 
and when the execution has begun. Also, there is an echo that 
informs the user of the completion of the decomposition and 
building passes. Upon completion of the translation process, all 
files are closed and the message "TRANSLATION COMPLETE" is 
displayed at the console. 
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3.2 Mappings 


There are two user-definable mappings to associate 2-80 and 
Z8000 CPU resources: the flag and register mappings. 


The flag map is a means of altering the generated 28000 
source code. For each Z-80 instruction that is translated, extra 
Z8000 instructions are added to keep the CPU flags compatible. 
The user can state which flags are to have extra code generated 
for them ("care" state) and which flags are not to generate extra 
code ("don't care" State). The user should determine whether the 
program to be translated has been coded to rely on particular CPU 
flags and set the mappings accordingly. Interactive. and source 
directive capabilities provide control of isolated sections of 
flag critical code. The default flag mappings are: 


€ Care 

Z Care 

Ss Care 

P/V Don't care 

N Don't care (called "D" flag in the Z8000) 
H Don't care 


These default mappings can be altered by the "FLAG" directive. 


The 2-80 CPU registers must be associated with 28000 CPU 
registers. Sixteen and eight-bit registers must be mapped 
appropriately to allow compatible execution. TRANS8000 does not 
check to insure that a logical association of registers is 
maintained. The default register mappings are: 


A - RHO 13 at SRO BEF AS RO 
B =" REL c - RbL1 Be t= <Ri 
D = RH2 E = Ri? DE = “R2 
H = RAS L - RL3 Ho. =" RS: 
Tx = Res ry = “Ria SP = RIS 
AF' -  R8 Be) =) RF DEY = RLO 
BL" = Rid 


These default mappings can be altered by the "REGISTER" 
directive. 
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A list of free registers is acquired at the beginning of 
each pass and whenever a register map is altered. When a scratch 
register is needed to build 28000 source instructions, one of the 
free registers can be _ used. The scratch register list is 
gathered by scanning the register map, starting with RO, and 
keeping any register not previously mapped. R7 is the highest 
numbered register in the scratch list because 8-bit registers are 
used for the scratch registers. The scratch registers are used 
only in the translation of Z-80 CPU instructions. They can be 
re-used for each instruction. 


3.3 User Controls 


The user is given control over the translator by the use of 
the options and directives. The areas of user control over the 
translator are: 


1. Generate relocatable or absolute 28000 PLZ/ASM source 

2. Display and set the register map 

3. Display and set the flag map 

4. Display Z-80 source, 28000 source, and messages on the 
console 

5. Include the Z-80 ASM source in the critique file 

6. Execute TRANS8000 in Interactive or Noninteractive mode 

7. Translate interactively on Pass One or Pass Two 

8. Step through the translation by lines 

9. Halt translation and return to the system 


The defaults are provided to generate relocatable code, to 
include the Z-80 ASM source in the critique file, to 
display only messages on console, and to execute in the 
Noninteractive mode. 


3.4 I/O Handling 


All file and console output interfaces with RIO through 
STREAM (which is a part of the TRANS8000 program). Console input 
allows character deletion: <backspace> key (ASCII %08), and line 
deletion: <delete> key (ASCII $%10). 
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The logical unit assignments made by TRANS8000 are: 


Unit 2 Console 

Unit 4 Intermediate file 
Unit 5 28000 source file 
Unit 6 Critique file 
Unit 7 2Z-80 source file 


All messages from the translator will appear at the console 
and in the critique file. Messages pertaining to a given source 
line will appear after that line has been processed. 


3<5 Errors 


When TRANS8000 determines that an execution error has 
occurred, processing will stop. An execution error is not 
directly related to the content of the source file, but is 
related to the environment in which the translator is running 
(memory availability, disk storage, etc.). When a condition 
arises that causes the translator to abort, the following events 
O@Ccur: 


l. any buffered messages get displayed, 
2. a hexadecimal abort-code is displayed, 
3. all files are closed, 

4. execution returns to the system. 


The abort-code can be either a RIO completion code or a 
TRANS8000 abort number (see Section 3.7, Implementation Note for 
code descriptions). 


The translation process can be aborted at any time by 
hitting the Escape <esc> key. 
3.6 Directives 

Options are set using directives. Directives can be entered 
via the command line, the Z-80 ASM source file (if the line is 


preceded by a "$" character), or via the console, in the 
Interactive mode. 


3.6.1 Description 
TRANS8000 prompts the user with a "T>" when console input is 


expected. Console input is always terminated by a carriage 
return. The directives that control TRANS8000 are: 
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DIRECTIVE OPTION 


"ABS" Generate absolute Z8000 source 

"BRIEF" Exclude 28000 source in critique file 

"DISPLAY" Display Z-80 and 28000 sources at the 
console 

"FLAG" Display or set flags 

"INTERACT" Enter Interactive mode 

p Sie Execute interactively during Pass One only 

bea se Execute interactively during Pass Two only 

"NODISPLAY" Inhibit sources from appearing at the 
console 

"NOINTERACTION" Leave Interactive mode 

SOuUrr" Halt execution of TRANS8000 

"REGISTER" Display or set register mappings 

"RELOC" Generate relocatable 28000 source 

"STEP" Translate lines interactively 

"VERBOSE" Include Z8000 source in critique file 


Directives can be entered as all uppercase, all lowercase, 
or mixed upper and lower case. All directives can be abbreviated 
to their shortest unique representation. More than one 
directive, separated by valid delimiters, may be entered ona 
line. If the same directive is entered more than once on a line, 
only the rightmost occurrence executes. Note that in the 
following descriptions, the user Should type the symbols enclosed 
in double quotes. 


The "FLAG" and "REGISTER" directives both have qualifiers 
for setting flag and register maps, respectively. 


3.6.2 Step 


The "STEP" directive allows the user to alter the flag or 
register mappings and other translator states at any point during 
the process. The "STEP" directive accepts three qualifiers: a 
number, a label, or an asterisk. A number qualifier, ranging 
from zero to 255, causes repeated processing of source lines 
until the count is exhausted. A label qualifier, six characters 
or less, will step until the line containing that label at its 
start has been processed. An asterisk qualifier will process 
until the end of the current pass. If no qualifier is specified, 
a number qualifier of one is implied. A directive line appearing 
in the source counts as a line when stepping. Also, "STEP" 
commands will not be processed if a Step command is already 
active. That is, no recursion of the Step command is allowed. 
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A number qualifier may be entered with radices of two, 
eight, ten, or sixteen by appending the appropriate base 
indicator after the number. No appendage implies a decimal 
value; the other appendages explicitly imply: 


"pm "pl a binary 

ro” al 6 a > octal 

Mig" ug" — octal 

"a" "p" -— decimal 

"nh"  "H" — hexadecimal 
EXAMPLE: 


TOSTEP 5 (steps 5 lines) 
T>STEP OCH (steps 12 lines) 
T>STEP * (steps to end of current pass) 


3-6.3 Flag 


The flag directive can be used to display the flag state or 
to set the flag states. The directive keyword "FLAG" by itself 
will display the current flag state. The directive keyword 
"FLAG" followed by a flag setting list enclosed in parentheses 
will set the flag states. The form of the flag directive is: 


flag-directive => "FLAG" 
=> "FPLAG" ai (ol List* | " 
list => flag-name [flag-setting] 
flag-name => new | We Ag | we | py | mye | "Aq" 
flag-setting => "ON" | "OFF" 


If any flag-name or flag-setting is duplicated, the rightmost 
occurrence will take precedence. 


The default setting for a list without a flag-setting 
specified is "ON". The "ON" keyword means that the flag is in a 
Care state, while the "OFF" keyword means the flag is in a Don't 
Care state. 


EXAMPLE: 
T>FLAG (ZC ON S OFF) 
This flag directive sets the Zero and Carry flags to Care, sets 


the sign flag to Don't Care, and does not affect the Parity, Half 
Carry, and Decimal Adjust flags. 
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3.6.4 Register 


The register directive can be used to display the register 
mapping or to set the register mappings. The directive keyword 
"REGISTER" by itself will display the current register mapping. 
The directive keyword "REGISTER" followed by a map setting list 
enclosed in parentheses will set the register map. The form of 
the register directive is: 


register-directive => "REGISTER" 
=> "REGISTERY "CY Taste * ")" 
list => 2-80-reg-name "=" 28000-reg-name 
2-8 0-reg-name => rp | wo" | Lpe | "BCH" 
=> mp" | wpe | "DE" | "DE 0 
=> LS = | Wa | LS Pa | w" HL' " 
=> Tie | LS i) | Ladi «il cs | "AF? " 
=> wax | ye | "op" 
Z8000-reg-name => RHO | RLO | RO 
=> RHI: | RET) | Ri 
=> RH2Z | REZ jt R2 
=> RHSe |) RIES, | RS 
=> RH4 | RL4, | R4 
=> (RES | any ale dO 
=> RH6 | RL6 | R6 
=> SRE eR yal Et 
=> R8 | RO | RLO 
=> RI |. RI le RLS 
=> R14 | R15 


If any register-mapping is duplicated, the rightmost 
occurrence takes precedence. Also, only mappings specified alter 
the current mappings. 


All 8 and 16-bit registers must be mapped individually. 
Therefore, mapping a 16-bit register pair does not imply that the 
two corresponding 8-bit registers, if they exist, are also 
mapped. 

EXAMPLE: 
T>REG (A=RH4 F=RL4 AF=R4) 


maps the two 8-bit registers and the 16-bit register of the 2-80 
and 28000 together. 
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3-7 Implementation Note 


The abort 


of the following codes are returned. 


CODE 


20 


MEANING 


Intermediate file out of sync or 
invalid record header in intermediate 
file 

Source directive sync error 
Intermediate record header error 

See 21 

See 22 

See 21 

See 22 

Scratch list overflow 

Request for scratch register overflow 
No scratch registers available 
Scratch register overflow 

Symbol table overflow 

Symbol table overflow 

Invalid next state while restructuring 
Source item buffer overflow 

Data name generator overflow 
Procedure name generator overflow 
Zero flag fixup error 

Sign flag fixup error 

Parity/overflow fixup error 


displayed by TRANS8000 are listed below. 
Codes in the range $20 to %3F are generated by TRANS8000. 
greater than %3F are ZDOS completion codes. 


Codes 
Contact Zilog if any 
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SECTION 4 


TABLES 


4.1 Opcode Tables 

The opcode table below lists the 2-80 instructions (with 
some repetition omitted) and the equivalent instruction(s) 
Produced by the translator. 

Instructions marked "NOT TRANSLATABLE" result from lack of 
architectural compatability. Registers are dependent on register 
mapping. Instructions uSing IY are not shown (because they are 
similar to IX). 

NOTATION: 
iyo: Any 2-80 registers 


Ebi, £b* Any Z8000 8-bit register (high or low), 


b = 0 to 7 

rn Any 28000 16-bit register, n = 0 to 15 

n An 8-bit value 

nn A 16-bit value 

d A displacement value 

e Signed two's complement number in range 
cel be Syl DOA Ae 

ss Valid 16-bit operands for the given Z-80 


instruction 


m Valid 8-bit operands for the given 2-80 
instruction 


vv Valid operands for given 28000 instruction, 
explicitly shown for preceding instruction 
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Z-80 Instruction 


LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 


RLC 


RLC 


cep pd 

i; hi 

EF, (HL) 

r, (IX+d) 
(HL), §& 
(IX+d) ,r 
A, (BC) 
A, (DE) 


(HL) 


(IX+d) 


OPCODE TABLE 


Equivalent 28000 Instruction 


LDB rb,rb' 
LDB rb,#n 
LDB rb,@rn 
LDB rb,d(rn) 
LDB @rn,rb 
LDB d(rn),rb 
LDB rb,@rn 
LDB rb, @rn 
LDB rb,nn 
LDB @rn,rb 
LDB @rn,rb 
LDB nn,rb 


*NOT TRANSLATABLE 
*NOT TRANSLATABLE 
*NOT TRANSLATABLE 


XORB rb,vv 
CPB rb,vv 
INCB rb,#1 
INCB @rn,#1 
INCB d(rn) ,#1 
DECB vv,#1 
ADD rn,rn 
ADC rn,rn 
SBC rm,rn 
ADD rn,rn 
INC rn,#1 
ING fn, #1. 
DEC. En, #1 
DEC rn,;#l 
RLB rb,#1 
RLCB rb, 
RRB rb,#1 
RRCB rb,#1 
RLB rb,#1 


LDB rb,@rn 
RLB rb,#1 
LDB @rn,rb.- 


LDB rb,d(rn) 
RLB rb,#1 
LDB d(rn) ,rb 
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2-80 Instruction 


RL m 
RRC m 
RR m 
SLA m 
SRA m 
SRL m 


RLD 


LD R,A 

LD ss,nn 
LD IX,nn 
LD ss, (nn) 
LD (nn) ,ss 
LD SP,HL 
LD SP,1IX 
PUSH dd 
POP dd 

EX DE,HL 
EX AF,AF' 


EXX 


EX (SP) ,HL 
EX (SP) ,1X 
LDI 

LDIR 

LDD 

LDDR 

CPI 

CPIR 

CPD 

CPDR 

ADD A,r 
ADD A,n 
ADD A, (HL) 
ADD A, (IX+d) 
ADC A,m 
ADC A, (HL) 


ADC A,n 


Equivalent 28000 Instruction 


RLCB vv 
RRB vv 
RRCB vv 
SLAB vv 
SRAB vv 
SRLB vv 


LDB rb,@rn 
RLDB rb,rb 
LDB @rn,rb 


*NOT TRANSLATABLE 
LD cn, #nn 
LD rn,*«nn 
LD rn,nn 

LD nn,rn 

LD: rn,;un 

UD: -Eny;,En 
PUSH @rn,rn 
POP rn,@rn 
BX, EN ;,.con 

EX En,En 


EX rn,rn 
EX rn,rn 
EX En,rFn 


EX rn,@rn 

EX rn,@rn 

LDIB @rn,@rn,rn 
LDIRB @rn,@rn,rn 
LDDB @rn,@rn,rn 
LDDRB @rn,@rn,rn 
CPIB rb,@rn,rn,EQ 
CPIRB rb,@rn,rn,EQ 
CPDB rb,@rn,rn,EQ 
CPDRB rb,@rn,rn,EQ 
ADDB rb,rb 

ADDB rb,#n 

ADDB rb,@rn 

ADDB rb,d(rn) 

ADCB rb,vv 

LDB rb,@rn 

ADG rb,rb 

LDB rb,#n 

ADC rb,rb 


Z-80 Instruction 


SUB m 
SBC A,m 
ADC A, (HL) 


ADC A,n 


AND m 
OR m 


RRD 


DAA 
CPL 
NEG 
CCr 
SCF 
NOP 
HALT 
DI 
EI 
IMO 
IM1 
IM2 
BI?’ b:£ 
BIT’ iby ( 
BIT 5;.¢ 
SEP bar 
SET: Bb; ( 
SET b, ( 
RES b,m 
JP nn 

JP CC ;nn 
JRe 

JR C,e 
JR NC,e 
JR Z,e 
JR NZ,e 
JP (HL) 
JP (IX) 


Equivalent 28000 Instruction 


SUBB rb,vv 
SBCB rb,vv 
LDB rb,@rn 
ADG Ebzrb 
LDB rb,#n 
ADC rb,rb 


ANDB rb,vv 
ORB rb,vv 


LDB rb,@rn 
RRDB rb,rb 
LDB @rn,rb 


DAB rb 
COMB rb 
NEGB rb 
COMFLG C 
SETFLG C 
NOP 

HALT 

DI VI 

EI VI 


*NOT 
*NOT 
*NOT 
BITB 
BITB 


TRANSLATABLE 
TRANSLATABLE 
TRANS LATABLE 
rb,#b 

@rn,#b 

d(rn) ,#b 
rb,#b 

@rn,#b 

d(rn) ,#b 

VV 
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Z-80 Instruction Equivalent Z8000 Instruction 


DJNZ e DBJNZ rb,e 
backwards jump only 
forward jumps not detected 


CALL nn CALL nn 


CALL CC,nn JR NOt “CC. S-+-2 
CALL nn 


RET RET 

RET CC RET CC 

RETI IRET 

RETN *NOT TRANSLATABLE 
RSP on *NOT TRANSLATABLE 
IN A,(n) INB rb,n 


EN CC) CLR rn 
LDB rb,rb 
INB rb @rn 


INI CLR rn 
LDB rb,rb 
CLRB rb 
INIB @rn @rn rn 
LDB rb,rb 


INIR CLReEn 
LDB rb,rb 
CLRB rb 
INIRB @rn @rn rn 
LDB rb,rb 


IND CLR rn 
LDB rb,rb 
CLRB rb 
INDB @rn @rn rn 
LDB rb,rb 


INDR CLR rn 
LDB rb,rb 
CLRB rb 
INDRB @rn @rn rn 
LDB rb,rb 


OUT (n),A OUTB n,rb 
OULD xr, (C) CLR rn 


LDB rbi,.rb 
OUTB rb @rn 
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Z-80 Instruction 


OUTI 


OTIR 


OUTD 


OTDR 


CLR rn 
LDB rb,rb 
CLRB rb 
OUTIB @rn 
LDB rb,rb 


CLR rn 
LDB rb,rb 
CLRB rb 
OTIRB @rn 
LDB rb,rb 


CLR rn 
LDB rb,rb 
CLRB rb 
OUTDB @rn 
LDB rb,rb 


CLR rn 
LDB rb,rb 
CLRB rb 
OTDRB @rn 
LDB rb,rb 


@rn 


@rn 


@rn 


@rn 


Equivalent 28000 Instruction 


rn 


rn 


rm 
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4.2 Pseudo-Ops 


The 2-80 pseudo-ops 


listed below. 
Z-80 Pseudo-Ops 


V1 DEFB 
V2 DEFW 
V3 DEFS 
V4 DEFM 


-35D55 


string' 


V5 DEFT ‘'string' 


V6 EQU n 
V7 DEFL xn 


GLOBAL 
EXTERNAL 


ORG 


COND n 
ENDC 


MACRO 
ENDM 


*EJECT 

*HEADING string 
*LIST ON 

*LIST OFF 
*INCLUDE file 
*MACLIST ON 
*MACLIST OFF 


iy Sh ry var MOD 
eNOT.., «AND., «ORs , 
\, &/T 

roHR..,; «SHI. 

2X RE St. 

sB Oe, oGlis,, «Lil's 


-UGT., .ULT. 
=) De < 
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and their equivalent 28000 syntax are 


Equivalent 28000 Syntax 


Vl BYTE =n 

V2 WORD :=n 

V3 ARRAY [ n BYTE ] 

V4 ARRAY [ * BYTE ] 
:= 'string' 

V5 ARRAY [ * BYTE ] 
:= 'Snnstring' 

CONSTANT 

V6 :=n 

No translation 

GLOBAL 

EXTERNAL 


SABS or SREL 


SIF n STHEN 
SFI 


No translation 


$ PAGE 

STITLE string 
SLISTON 1 
SLISTON 0 
SINCLUDE 'file' 
No translation 
No translation 


ty, =) ee Jt MOD 

LNOT, LAND, LOR, LXOR 
LNOT, LAND, LOR 

SHR, SHL 


No translation 


4.3 Flag Tables 


The following list shows all the Z-80 instructions that fit 
into a particular flag-fixup sequence. Each of the six flags are 
assigned a fixup action. Therefore, the six fixup actions 
determine the code that will appear for an equivalent translation 
of a given instruction. Any of the fixup actions (or flags) can 
be set to a "don't care" state; in this case, the fixup action 
will not generate any extra code during the translation of the 
instruction. The "FLAG" directive is used to control the Care or 
Don't Care setting of the six flags (see directive description 
for defaults). 


NOTE: "-16" concantenated to an opcode refers to a 16-bit 
operation. 
FLAGS 


C Z s P/V N H 


0 - unaff unaff unaff unaff unaff unaff 


call 
di 
djnz 
ei 

ex 
exx 
halt 
in_(n) 
jp 

as 

ld 
nop 
out (n) 
out _(c) 
pop 
push 
res 
ret 
reti 
retn 
rst 
set 


1 - unaff save save £ix reset reset 


ldd 
ldi 
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adc_16 
adc 
add 


affect 


sbc_16 
sbe 


sub 


unaff 


dec_16 
inei16 


affect 


rla 
rlca 
rra 
rrca 


affect 


ical 

Led Ko; 
FY 

Fre 
sla 
sra 
rld 
rrd 
srl 


save 


cpdr 
cpir 


save 


affect 


affect 


affect 


save 


save 


affect 


affect 


fix 


affect 


affect 


save 


save 


affect 


Fax: 


affect 


affect 


affect 


save 


save 


ELX 


reset 


set 


reset 


set 


save 


reset 


reset 


see 


nofix 


nofix 


nofix 


save 


reset 


reset 


nofix 


10 


ll 


12 


13 


14 


15 


16 


18 


19 


20 


21 


dec 
affect 
add_16 
affect 
daa 
unaff 
cpl 
affect 
eer 


set 


affect 


affect 


affect 


affect 


save 


affect 


save 


unaff 


unaff 


(not used) 


unaff 


but 


unaff 


in_(c) 


affect 


Fix 


ye. 


affect 


affect 


affect 


affect 


affect 


save 


fix 


save 


unaff 


unaff 


nofix 


1 Beal 


P/V 


affect 


affect 


affect 


affect 


affect 


save 


LHD 


save 


unaff 


unaff 


nofix 


Pix 


reset 


set 


reset 


set 


reset 


unaff 


set 


reset 


reset 


reset 


reset 


reset 


nofix 


nofix 


nofix 


unaff 


nofix 


set 


nofix 


reset 


set 


nofix 
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C Z s P/V N H 


22 - unaff ft nofix nofix set nofix 


23 = 


ind 
ini 
outd 
outi 


unaff set nofix nofix set nofix 
indr 
inir 
otdr 
OULE 


24 - unaff unaff unaff unaff reset reset 


scf 


The following algorithm is used to generate flag-fixup 
for instruction translation. 


(1) 


(5) 


(6) 


(7) 


(8) 


(9) 
(10) 


(iy) 


Mask instruction flags with current flag mapping. 


Save FLAGS in temporary register if any flag is 
a “Savye™ or “fax. 


Build equivalent line(s) of source code. 


code 


Save FLAGS in temporary mask register if any flag is 
an "affect" and any other flag is a "Save" or "fix". 


If (4), mask out flags in temporary mask register 
which are not "affect". 


If (2), mask out flags in temporary mask register 
which are "affect" or "fix". 


If (2) and (4), combine temporary register and 
temporary mask register into temporary register. 


Generate instruction(s) to fix each flag which is 
DOE TOUS 


If (2), restore FLAGS from temporary register. 
Reset any flag which is a "reset". 


Set any flag which is a "Set". 


APPENDIX A 


EXAMPLES 


A.1 General Example - DEM01.S 


This 


".2Z28000.S" 


example contains a mixture of Z-80 instructions and 
assembler pseudo-ops in a typical program format. The example 
was translated using the default mappings. The ".S", ".CRIT" and 


files 


are shown to illustrate translator usage. 


*H THIS IS A TEST 


EX1 EX2 EX3 EX4 ;SEE FILE OUTSIDE.S 
GLB1 GLB2 GLB3 


0 
a 
OFFH 
START+4 
100 
2 

80 


A,B 

HL, BC 

B,C 

(IX+80H) ;OFFSET FROM RECORD 
LAB1 
A,B 


B,C 


2 


;THIS STARTS ROUTINE TWO 


EXTERNAL 
GLOBAL 
GLB3 DEFB 
INTL DEFB 
EQUI EQU 
EQU2 EQU 
EQU3 EQU 
INT2 DEFB 

DEFS 
GLB1 LD 
ADD 
LD 
AND 
JP 
LAB1 LD 
CPIR 
LD 
DI 
IM 
RET 
INT3 CALL 
GLB2 CALL 
RLC 
EXX 
LDI 
LD 
RET 
INT4 DEFS 
INT5 LD 
LD 
INT6 DEFT 


PROCESS 
NZ, EX1 
H 


(IY+START) ,GLB1 


256 


A,B 
HL, EX2 


'TITLE''S : (seldom used) ' 
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DEMO1.28000-.S 


DEMO1 MOD MODULE 
$TITLE THIS IS A TEST 


EXTERNAL 
EX1 LABEL 
EX2 LABEL 
EX3 LABEL 
EX4 LABEL !SEE FILE OUTSIDE.S! 


GLOBAL 
GLB] LABEL 
GLB2 LABEL 


GLB3 BYTE :=0 


INTERNAL 
INT] BYTE :=1 


CONSTANT 

EQU1 := %SOFF 
EQU2 START+4 
EQU3 100 


INTERNAL 
INT2 BYTE <= 2 
NAME 01 ARRAY [ 80 BYTE ] 


PROC 01 PROCEDURE 


ENTRY 
GLB1: LDB RHO RH1 
LDCTLB RL4 FLAGS 
ADD R3 Rl 
LDCTLB RH4 FLAGS 
ANDB RH4 #%(2)00100000 
ANDB RL4 #%(2)00011111 
ORB RL4 RH4 
LDCTLB FLAGS RL4 
LDB RH1 RL1 
ANDB RHO $80 (R13) !OFFSET FROM RECORD! 
RESFLG C 
JP LAB1 
LAB1: LDB RHO RH1 
LDCTLB RL4 FLAGS 
CPIRB RHO @R3 Ri .Z 
LDCTLB RH4 FLAGS 
ANDB RH4 #% (2)00011000 
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ANDB RL4 #% (2)00100111 


ORB RL4 RH4 
LDCTLB FLAGS RL4 
LDB RH1 RH1 
DI VI 

{IM ait 

RET 


!THIS STARTS ROUTINE TWO! 
INT3: CALL PROCESS 


GLB2: JR Z $+4 
CALL EX1 
RLB RH3 #1 
EX Rl R9 
EX Rl R10 
EX R3) R17 
LDCTLB RL4 FLAGS 
LDIB @R2 @R3 RI 
LDCTLB FLAGS RL4 
LDB START(R14) #GLB1 
RET 


END PROC 01 
INT4 ARRAY [ 256 BYTE ] 


PROC_02 PROCEDURE 
ENTRY 
INT5: LDB RHO RH1 
LD R3 #EX2 


END PROC 02 


INT6 ARRAY [ * BYTE ] := '$17TITLESQS 


END DEMO1 MOD 


(seldom used) ' 
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DEM01.CRIT 


( C ZS PV NH ) - CARE CARE CARE DONT CARE DONT CARE DONT CARE 


( 280 - 28000 ) 


B-RH1 G-RL1 D-RH2 E-RL2 
H-RH3 L-RL3 A-RHO F-RLO 
BE=R1L DE-R2 HL-R3 AF-RO 
TXSR13 IY-R14 SPR BE'=R9 


DE’=R10) HERI AF '-R8 


*H. THUS LS A TEST 


EXTERNAL EXl EX2 EX3 EX4 ;SEE FILE OUTSIDE.S 


GLOBAL GLBl1 GLB2 GLB3 
GLB3 DEFB 0 
INT1 DEFB 1 
EQU1 EQU OFFH 
EQU2 EQU START+4 
EQU3 EQU 100 
INT2 DEFB 2 
DEFS- 80 
GLB1 LD A,B 
ADD HL,BC 
LD B,C 
AND (IX+80H) ;OFFSET FROM RECORD 
JP LAB1 
LAB1 LD A,B 
CPER 
LD B,C 
DI 
IM 2 
*** QOPCODE NOT TRANSLATABLE 
RET 


;THIS STARTS ROUTINE TWO 
INT3 CALL PROCESS 
GLB2 CALL NZ,EX1 
RLC H 
EXX 
LD1 
LD (IY+START), GLB1 
RET 
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INT4 DEFS 256 


INT5 LD A,B 
LD HL,EX2 
INT6 DEFT 'TITLE''S : (seldom used) ' 
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A.2 Flag Example — DOCFF.S 


This example shows the flag fixes for an instruction given 
varying Care and Don't Care patterns. The fixup pattern number 
refers to the flag tables of Section 4.3. Only the flags 
requiring fixing are varied. Also note the use of directives in 
the source file. 


--- ] --- FIXUP PATTERN 

@FLAG(C ZS PV N H ON) 

id. EDD ;S ON PV ON 

@FLAG(S ON PV OFF) 

2. . LBD ;S ON PV OFF 

3FLAG(S OFF PV ON) 

BS DDD :S OFF PV ON 

@FLAG(S OFF PV OFF) 

né. EDD :S OFF PV OFF 

;--- 21 --- FIXUP PATTERN 

@FLAG(C ZS PV N H ON) 

tie IN OR, 6e) :Z ON SON PV ON 
3FLAG(Z OFF S PV ON) 

Tae” EN | PBs Ge) ;Z OFF S PV ON 
@FLAG(Z S OFF PV ON) 

23.0 IN: B,C) :Z2 S OFF Pv ON 
3FLAG(Z ON S OFF PV ON) 

Ties cE BAe) :Z ON S OFF PV ON 
%FLAG(Z S ON PV OFF) 

TS (EN Byte) :Z S ON PV OFF 
%FLAG(Z OFF S ON PV OFF) 

PG IN > BCS) :Z OFF SON PV OFF 
$FLAG(Z ON S PV OFF) 

Ey... UN? --By CC) :Z ON S PV OFF 
@FLAG(Z S PV OFF) 

te IN Bec) ;Z S PV OFF 
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DOCFF .Z8000.S 


DOCFF_ MOD MODULE 


is-- | =-— FIXUP PATTERN! 
INTERNAL 
PROC 01 PROCEDURE 
ENTRY 

Li: LDCTLB RL4 FLAGS 
LDDB @R2 @R3 Rl $!S ON PV ON! 
!FIXUP PV FLAG! 
TEST Rl 
CLRB RH4 
TCCB NZ RH4 
RLB RH4 #2 
ORB RL4 RH4 
LDCTLB FLAGS RL4 
RESFLG N 4H 

2s LDCTLB RL4 FLAGS 
LDDB @R2 @R3 Rl $!S ON PV OFF! 
LDCTLB FLAGS’ RL4 
RESFLG N 4 

Liss LDCTLB RL4 FLAGS 
LDDB @R2 @R3 Rl !S OFF Pv ON! 
!FIXUP PV FLAG! 
TEST Rl 
CLRB RH4 
TCCB NZ RH4 
RLB RH4 #2 
ORB RL4 RH4 
LDCTLB FLAGS RL4 
RESFLG N 4H 

L4: LDDB @R2 @R3 Rl $!S OFF Pv OFF! 
RESFLG N 4H 

!--- 21 --- FIXUP PATTERN! 

Ls LDCTLB RL4 FLAGS 
CLR R4 
LDB RL4, RL1 
INB RH] @R4 !2 ON S ON PV ON! 
{FIXUP 2Z FLAG! 
TESTB RH1 
CLRB RH4 
TCCB Z RH4 
RLB RH4 #2 
RLB RH4— #2 
ORB RL4 RH4 
!FIXUP S_ FLAG! 
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E22 


res 


I4: 


TESTB 
CLRB 
TCCB 
RLB 
RLB 
ORB 

! FIXUP 
TESTB 
CLRB 
TCCB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 
NELRUP 
TESTB 
CLRB 
TCCB 
RLB 
RLB 
ORB 
!FIXUP 
TESTB 
CLRB 
TCCB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 
!FIXUP 
TESTB 
CLRB 
TCCB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 

! FIXUP 
TESTB 
CLRB 


RH1 

RH4 

MI RH4 
RH4 #1 
RH4 #2 
RL4 RH4 
PV FLAG! 
RH1 

RH4 

PE RH4 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 


RH1 @R4 !2Z OFF S PV ON! 
S FLAG! 


RH1 

RH4 

MI RH4 
RH4 #1 
RH4 #2 
RL4 RH4 
Pv FLAG! 
RH1 

RH4 

PE RH4 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 


RH1 @R4 !2Z S OFF PV ON! 
PV FLAG! 


RH1 

RH4 

PE RH4 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 
RH1 @R4 $!2 ON S OFF ©PV OM! 
Z FLAG! 
RH1 

RH4 


£5: 


E6¢ 


Las 


TeCCB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 
!FIXUP 
TESTB 
CLRB 
TCCB 
RLB 
RLB 
ORB 

LE LXUP 
TESTB 
CLRB 
TCCB 
RLB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 

! FIXUP 
TESTB 
CLRB 
TCCB 
RLB 
RLB 
ORB 
LDCTLB 
RESFLG 
LDCTLB 
CLR 
LDB 
INB 
!FIXUP 
TESTB 
CLRB 


Z RH4 

RH4 #2 
RH4 #2 
RL4 RH4 
PV FLAG! 
RH1 

RH4 

PE RH4 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 
RH] @R4 

Z FLAG! 
RH1 

RH4 

Z RH4 

RH4 #2 
RH4 #2 
RL4 RH4 

S FLAG! 
RH1 

RH4 

MI RH4 
RH4 #1 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 
RH1 @R4 

S FLAG! 
RH1 

RH4 

MI RH4 
RH4 #1 
RH4 #2 
RL4 RH4 
FLAGS RL4 
N 

RL4 FLAGS 
R4 

RL4,RL1 
RH1 @R4 

Z FLAG! 
RH1 

RH4 


!Z S ON 


!Z OFF 


!Z ON 


PV OFF! 


ON PV OFF! 


S PV OFF! 
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TCCB Z RH4 


RLB RH4 #2 
RLB RH4 #2 
ORB RL4 RH4 
LDCTLB FLAGS’ RL4 
RESFLG N 
18: CLR R4 
LDB RL4,RL1 
INB RH1 @R4 !2 S PV OFF! 
RESFLG N 


END PROC 01 
END DOCFF MOD 
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Z8000 DEVELOPMENT MODULE 
Timing and Logic Diagram 
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Features: 


Z8000 Microprocessor 

2K words EPROM (expandable to 8K) 

16K words Random Access Memory (expandable to 32K) 
Dual serial interfaces (110-19.2K Baud) 

32 programmable I/O lines with handshake controls 
Four programmable 8-bit counter/timers 

Wire wrap area (18 sq. inches) 

Jumper-selectable CPU clock rates 


Description: 


The Z8000 Development Module is a complete, single board 
Z8000 microcomputer system specifically designed to assist 
the user in evaluating and developing hardware and software 
for Z8000-based products. It contains the Z8002 micro- 


processor, 16K words of dynamic RAM, 2K word monitor 
PROM, dual serial interfaces, four counter/timers and 32 
programmable parallel I/O lines. The memory resources of 
the board may be easily expanded with the addition of 

16K RAM and 2K EPROM components. A wire wrap area 
also allows for addition of custom interfaces or special 
applications circuits. 


The Z8000 Development Module is a high-performance 
prototype system with designed-in flexibility to accommodate 
a wide range of user applications. A variety of jumper areas 
and switches permit: 


Selection of 2.5 or 3.9 MHz clock rates 

Use of 2708, 2716 or 2732 EPROM’s 

Use of 4K or 16K Random Access Memories 
Serial interface to modem, terminal or teletype 
I/O port addressing 

Baud rate selection (110-19.2K Baud) 


Bo oo bo 
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General: 


The Z8000 Development Module communicates with the out- 
side world using the two RS232C serial interfaces. For stand- 
alone operation a single jumper-selectable interface for 
RS232C or current loop is used to communicate with a 
console device. The other serial interface may be connected 
to a Zilog Microcomputer or Development System to allow 
downloading and uploading of program information, using a 
utility program in the host computer system. The Develop- 
ment Module is easily interfaced to the Zilog host with a cable 
connection; no additional hardware is required. 


Software Features: 


The monitor program, contained in 4,096 bytes of EPROM, 
provides the necessary debugging commands, input/output 
control and host interface for the Z8000 Development 
Module. It consists of a terminal handler, command inter- 
preter, debugger and upload/download handler. 


= Terminal Handler — provides interface to console 
device, either RS232C or current loop, to facilitate out- 
put to a display or printing mechanism and input from 
an alphanumeric keyboard. 


= Debugger — provides a basic set of debug commands 
to allow the user to start and stop program execution 
easily, display and alter CPU register, flags or memory, 
and trap instruction sequences. 


CONSOLE 


HOST SYSTEM 


Fig. 1. Monitor Block Diagram 
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= Command Interpreter — scans console inputs, insures 
command validity and passes requests to other software 
modules in the 4K monitor. 


= Upload/Download Handler — provides an interface 
between the serial connection and the host computer, 
the command interpreter and the memory resources of 
the Z8000 Development Module. It formats and inter- 
prets asynchronous data streams to and from the host 
and provides error checking and recovery for the serial 
interface. 


Upload/Download Feature: 


The upload/download feature allows data to be transferred 
from or to the Zilog host computer system. This feature 
requires that the Z8000 Development be serially connected to 
the Zilog host and console device. In this configuration the 
Z8000 Development Module serves as a message switcher and 
sits on the communications link between the console for the 
Zilog host and the console itself. 


The execution of a LOAD or SEND command from the 
console invokes a data transfer sequence to or from the host. 
After successful transfer, control is returned to the console. 
Checksum errors are reported on the console and the transfer 
is aborted when the user depresses the escape key. 


The format for transferred data blocks is illustrated in the 
figure below. This format is also used by the PUNCH and 
TAPE commands for paper tape input or output via the 
console device. 


DATA 


Fig. 2. Serial Data Format 


Z8000 Development Module (Board size : 27.9 35.6 cm) 


16K WORDS OF RAM 
= EXPANDABLE TO 32K WORDS 


2K WORDS OF EPROM 
= EXPANDABLE TO 8K WORDS 


= 4K AND 16K MEMORY COM- POWER CONNECTOR = 2708, 2716 AND 2732 
PONENTS ARE SUPPORTED ee EPROMS ARE SUPPORTED 
=| ni n> 
4 rr w 
o ltt 


prrrtty 


fereces 


seeeere 


i ae 


eposeeonee 


apoesece 


RESET SWITCH Z8000 MICROPROCESSOR CPU BUS INTERFACE 


= Z8001 AND Z8002 = BUFFERED Z8000 SIGNALS 
SUPPORTED = AVAILABLE USING J01 
NON-MASKABLE INTERRUPT & JUMPER SELECTABLECLOCK a AVAILABLE TO WIRE WRAP 
SWITCH RATE AREA 


DUAL SERIAL INTERFACES 


Z80-S10/2 

SELECTABLE DATA RATES 
Z80A-CTC 

20MA CURRENT LOOP 


RS232C CONNECTOR 
(TO/FROM HOST) 


RS232C/20 MA 
CURRENT LOOP CONNECTOR 
(TO CONSOLE DEVICE) 


/0 INTERFACE LOGIC 

e SELECTABLE ADDRESS 
RANGES 

m INTERFACES Z80A 
PERIPHERALS TO Z8000 CPU 
BUS 


PARALLEL /0 


= 32 PROGRAMMABLE I/0 LINES 
= HANDSHAKE CAPABILITY 


WIRE WRAP AREA 


= APPROX. 18 SQ. INCHES 
= USER APPLICATIONS 
DEVELOPMENT 
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Command and Summary: 


The following notation is used in the command description. 


<-> 


BREAK < address> 
[<n>] 


COMPARE 
< address 1> 
<address2> <n> 


DISPLAY <address > 
<n> [L|W|B] 


FILL <address 1> 
< address 2> < word> 


GO 


IOPORT < address> 
[W |B] 


JUMP < address > 
MOVE < address 1> 


<address2> <n> 


NEXT [<n>] 
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Enclose descriptive names for the 
quantities to be entered, and are 
not actually entered as part of the 
command. 


Denote optional entries in the 
command syntax. 


Denotes ‘‘OR’’, eg. W|B denotes 
that either W or B may be used 
but not simultaneously. 


Sets and clears a breakpoint at a 
given memory address. The 
option <n> allows specification 
of the number of occurrences, 
where n is from 1 to 128. The 
default is one. 


Compares two blocks of memory 
data beginning with the addresses 
specified for < n> bytes, where n is 
from 1 to 128. Errors are reported 
on the console device. 


Displays and modifies memory 
for <n> number of words or 
bytes. The optional entry allows 
data to be handled as bytes, words 
or long words. The default is 
words. 


Stores the < word> from 
memory address | to and includ- 
ing address 2. 

Begins program execution at the 
address contained in the current 
PC; execution is resumed where it 
was last interrupted. All registers 
are restored prior to execution. 


Allows direct communications 
from the console to a selected I/O 
port. A word (W) or a byte (B) 
may be read from the selected port 
and a word or byte may be sent to 
the selected port; default is byte. 


Unconditional branch to the 
specified address. All registers are 
restored prior to execution. 


Moves contents of a memory 
block from source address 

< address 1> to destination 
address < address 2> for <n> 
bytes. 


Executes the next <n> machine 
instructions. <n> may be from 1 
to 128. If nis omitted 1 is 
assumed. 


PUNCH < address 1> 
< address 2> 


QUIT 


REGISTER 
[< register name> ] 


TAPE 


Specifications: 


CENTRAL 
PROCESSOR 


MEMORY 


INPUT/OUTPUT 


INTERRUPTS 


PHYSICAL 
CHARACTERISTICS 


Punches a copy of memory from 
address | to address 2 on paper 
tape on the console device. 
Automatically turns on punch and 
a null leader is created. 
Upload/Download section 
describes the tape format used. 


Places serial channels into 
transparent mode. The Z8000 
Development Module must be 
connected to both the Zilog host 
and the console device, and the 
Development Module acts as a 
message switcher. 


Allows examination and 
modification of Z8000 registers. 
8-bit, 16-bit or 32-bit quantities 
may be selected by the appropriate 
register-naming conventions. 


Loads memory from paper tape 
via the console device. The 
Upload/Download section 
describes the tape format used. 


CPU: Z8002 
Clock Rate: 2.5 MHz or 3.9 MHz 


ROM: 2K words 2716 (expandable 
to 8K words) 

RAM: 16K words 6116 (expand- 
able to 32K words) 


Parallel: 32 lines (two Z80A-PIO’s) 
Serial: Dual RS232C or RS232C 
and Current Loop (Z80A-SIO) 
Note:The user has access to all bus 
signals which allow custom 
system expansion into the 
wire wrap area or off-board. 


Maskable Vectored (256) 
Maskable Non-Vectored 
Non-Maskable 
Segmentation Trap 


Height: 1.75in. 
Width: 14.0in. 
Depth: 11.0in. 
Weight: approx. 300z. 


4.5cm 
35.6cm 
27.9cm 
850gm 


CURRENT ADDRESS 
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Sheet 1. PROM Memory Read Timing 
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Sheet 2. Synchronous RAM Timing-Read Cycle, Refresh Cycle 
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Sheet 3. Synchronous RAM Timing-Write Cycle 
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Sheet 4. I/O Read Timing 
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Sheet 5. I/O Write Timing 
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Sheet 6. Interrupt Acknowledge 
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DATA out = ( SEDH) 


Eur 
(Bus out) 


Sheet 7. RETI Cycle 
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{ SAME AS PREVIOUS CYCLE 


Sheet 8. BUSRO/BUSAK Cycle 
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Sheet 10. RAM Memory Early Write Cycle 
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Z8000 DEVELOPMENT MODULE 
Monitor Program Listing 
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SECTION 1 


INTRODUCTION 


1.1 General 


The Z8000 Development Module (DM) Monitor Program is 
provided on the 28000 DM for use with the non-segmented 28002 
CPU. The program resides in 2K of EPROM on the board, starting 
at location 0, and uses an additional 576 words of dynamic RAM at 
locations %4000 through %447F for work space, program status 
area, and stack. This manual describes the most useful I/0 
procedures in the monitor program and contains a listing of the 
complete program. Detailed operating information for the monitor 
program is contained in the 28000 DM Hardware Reference Manual. 
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SECTION 2 
I/O PROCEDURES 


2.1 General 


The most useful I/O procedures are described and listed in 
this section. These procedures can be called upon by the user 
program to perform I/O functions through the console. 


2.2 I/O Procedures 


TYIN (%OFAO) 


Get a character from the keyboard buffer. If the buffer is 
empty, this procedure waits for a character to appear. The 


character is stored in register RLO, and the contents of register 
RHO are destroyed. 


TYWR (%OFC8) 


Display a character in RLO to the terminal. The character 
will not be displayed if the XOFF character is received before 
this procedure is executed. This procedure waits until an XON 
character is received to display the character in RLO. If the 
display character is a carriage return, the zero flag is set and 
RHO is destroyed. 


PUTMSG (%OFCO) 


Send a character string to the terminal. Register R2 
contains the address of the character string buffer, and the 
first byte in the buffer is the number of characters to be 
displayed. If there is no carriage return in the string, the 
entire string specified will be displayed, otherwise the string 
will be displayed up to and including the first carriage return. 
Register contents RO, Rl, and R2 are destroyed. 


TTY (%OFDC) 


Receive and echo at the terminal a line of character string 
up to the first carriage return. The character string is stored 
in a buffer pointed to by register R2. Register Rl contains the 
size of the buffer. If the size of the character string received 
from the terminal exceeds the size of the buffer, the zero flag 
is set. All lower case alpha characters are converted to upper 
case characters before storing in the buffer. Rl returns the 
actual number of characters received from the terminal. The 
contents of registers RO and R2 are destroyed. 
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CRLF (%OFD4) 


Output a carriage return followed by a line feed to the 
terminal. Register contents RO are destroyed. 


2.3 I/O Procedures Program 


The following is a sample program to illustrate the I/O 
procedures introduced in this section. The progaram sends a 
message to the console to request an input which must match the 
string "Z8000". When the string is matched, a string of up to 20 
characters is requested from the console for continuous display. 
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ZBO00ASH 0.45 
LOC = OBJ CODE = STMT SOURCE STATEMENT 


i EXAMPLES MODULE 


2 

3 CONSTANT 

4 

3 ) SYSTEM EQUATES LINK TQ 28000 DH MONITOR PROGRAM ! 
6 ! INPUT/QUTPUT PROCEDURE ! 

7 

8 TYHR = t= ZOFCB 

<4 TYIN = ?= ZOFAO 

10 TTY t= ZOFDC 

ii PUTHSG == ZOFCO 

12 CRLF = t= ZOFD4 

13 

14 ASCICR := ZOD ! CARRIAGE RETURN ! 
15 BUFSIZ = 20 

16 

17 

18 INTERNAL 


0000 Ob 50 4C 19 LODMSG ARRAY £14 BYTE] = C132/P' oh’ ytE% Al eS yEMD? 2, 
0003 45 41 53 

0006 45 20 4 

0009 4F 47 4F 

0000 4E OD 

20 TL? 0?071 7G? 1/0" oN? ASCICRI 

QOOE 13 57 48 21 MESHSG ARRAY C20 BYTE] t= C19 cH TATA? Pet T Gly 
0011 41 54 20 

0014 49 53 20 

0017 54 48 45 

OO1A 20 4D 45 

O01D 53.53 41 


0020 47 45 
22 Ba al A SU Maa LA Meas REC V CL | 
23 
0022 24 BUFFER ARRAY CBUFSIZ BYTE) 1 INPUT BUFFER ! 
25 
0036 26 QUTBUF ARRAY CBUFSIZ+1 BYTE] ! OUTPUT BUFFER ! 
27 
26 
0000 29 MAIND PROCEDURE 
30 
SL ENTRY 
0000 2102 0000’ = 32 LD R2,#LODHS6 ! SEND ’PLEASE LOGON’ TO ! 
3% ! CONSOLE ! 
0004 SFOO OFCO 34 CALL = PUTHSG 
35 
0008 CB3A 36 LDB RLO#? 2? 
000A SFOO OFCB 37 CALL =—-TYWR 1 SEND CHARACTER : TO CONSOLE! 
38 
QOOE 2102 0022’ 39 LD R2, BUFFER 
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0012 4101 0014 RL BUFSIZ 
9016 SFOO FDC TTY ! ACCEPT INPUT FROM CONSOLE ! 


OOLA E6F2 Z+ MAIND ! INPUT LINE 100 LONG ! 
O01 5402 0022’ RR2 BUFFER 

0020 1002 RR2»#'7800! 

0022 5A583030 

0026 EEEC JR NZ, HAIND ! INPUT MUST BE ’Z8000' ! 
0028 4001 0026? BUFFER+4 #70? 

0020 3030 

O02E EEEB JR NZ»MAIND 


50 REPEATS: 
0030 2102 000E’ R2, #MESHSG ! SEND ’WHAT IS THE MESSAGE’ ! 
0034 SFOO OFCO PUTHSG ! TO CONSOLE ! 


0038 SFOO OFD4 CRLF ! OUTPUT CARRIAGE RETURN & ! 
! LINE FEED 10 CONSOLE ! 


1 ACCEPT MESSAGE FROM CONSOLE AND OUTPUT THE MESSAGE ! 
! CONTINUOUSLY TO THE CONSOLE ! 


0030 CBSA RLO1#? 3? 
QO3E SFOO OFCB TYHR ! QUTPUT CHARACTER ?:? | 


0042 2102 0022! R2,#BUFFER 

0046 6191 0014 RL BUFSIZ 

004A SFOO OFDC TTY 1 ACCEPT LINE FROM CONOLE ! 
O04E EdFO Z1 REPEATS ! INPUT LINE TOO LONG ! 


0050 6£09 0036? OQUTBUF »RLi ! # OF CHARACTER IN INPUT LINE! 

0054 2103 0022! RS, BUFFER 

0058 2102 0037? R2,#0UTBUF +1 

N05C BASL 0120 @R2,BR3/R1 | MOVE MESSAGE TO OUTPUT BUF! 
72 

73 LOOP: 

0060 2102 0036’ R2,#0UTBUF 

0064 SFO0 OFCO PUTHSG 

0068 EBFB LOOP ! QUTFUT MESSAGE FOR EVER ! 


O06A 78 END MAIND 


79 
80 END EXAMPLES 
81 
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SECTION 3 


MONITOR PROGRAM LISTING 


3.1 General 
The following is a complete listing of the monitor program. 


An explanation of each module of the program is contained in a 
starred (*) box in the module listing. 
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ZB000ASH 0.45 
LOC = OBJ CODE = STMT _ SOURCE STATEMENT 


ZDISPLAY MODULE 


$SECTION DATI 

CONSTANT 
RXRDY 
TARDY 
PARITY 
LOWCSE 


1 TTY STATUS ! 


! PARITY BIT 7 ! 
' LOWER CASE | 


ea | ae it 


_— 
oso cm N O&® OF ob C4 PO 


! PORT ADDRESS ! 


ra 
— 


SIODA 
SIODE 
SI10CA 
SIOCB 
CTO 
CTC1 
CTC2 
CICS 
SWITCH 
RETI 


“FFL? =. | STO CHANNEL A BATA ! 
“FFAB =| STO CHANNEL B DATA ! 
“FFD =! STO CHANNEL A CONTROL! 
“FFF =! SIO CHANNEL B CONTROL! 
MFFAL 

UFFAS 

“FFAS 

MFFi?, =} CTC 3 FOR INTERRUPT! 
“FF21 | «BAUDE RATE SETTING ! 
“FF29 =} RESET CTC3 PORT ADDR ! 


a 
m &I rm 


J 
on 


eM Mm ¢ me tat ee meet [| 


a 
Oo 


COUNTER : “47 ~~! COUNTER MODE FOR CIC! 
CNTHOD 4(2)11000111 ! COUNTER MDE CTC3 ! 


USERAM t= 44460 =! USER PROGRAM AREA ! 
| AHHEEHHB EHH HHEE HEEB HHEHHB HH BHEEHHHHEEEE | 


PSAREA : 24400 

PSBRK 44406 | BREAK USE ILLEGAL INST. ! 
FOR TRAP ! 

NMI INTERRUPT ! 

CTC INTERRUPT VECTOR 6! 

S10 CH.By KB INTERRUPT! 
VECTOR 14 ! 


! 
PSNMI “4416! 
! 
| 
! 
PSCBRY : “444A | STO CH.B SPECIAL REC. ! 
! 
| 
! 
! 
! 


PSCTC 24424 
PSKBIN 14446 


VECTOR 16 ! 
PSMZIN : 14456 


S10 CH.Ay 
VECTOR iC ! 

S10 CH.A SPECIAL REC. ! 
VECTOR 1£ ! 


MCZ INPUT =! 
! 


PSCARV : 24458 


VINT (2) 0001000000000000 
! VECTOR INT.BIT MASK ! 
1 FCW WORD ! 
BVINT =: 12 1 BIT 12 FOR VECTOR INT. ! 
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476 


40B0 
4130 
41B0 
4280 


4380 
4382 


43B4 
43B6 


ESCHAR i= “1B! 
ASCICK i= x00 
ASCILF é= 20A 
BACKSP t= 208 
DELTE = AUF 
XOFFC i= “13 
XONC = t= “11 
TAPOFF t= “14 
TAPON = i= 412 
STACK i= “AOA! 
! 
CISIZE i= 2g 
COSIZE t= 128! 
~ RBSIZE t= Zuo | 
CHDNUH := } 


15 } 
! BIT POSITION IN XOFFON 


TRNMDE 
SNDNDE 
LODMDE 
INHOLD 


se Se ol OS 


OUTHLD 


Ww 
mo 


ESCAPE 


un 
ow 


XHSK 


" 
= 
oe 


84 $ABS 740B0 


85 


86 GLOBAL 


87 
88 
89 
90 
91 
92 
93 
94 
%5 
96 
97 
98 


CONIBF ARRAY (128 BYTE] 
CONOBF ARRAY C128 BYTE] 
RINGBF ARRAY (256 BYTE] 
HCZBUF ARRAY (256 BYTE] 


CBUFADR WORD 
CBUFSIZ WORD 


INPTR WORD 
QUTPTR WORD 


ESCAPE FOR ABORT LOAD/SEND! 


STACK POINTER ! 
SIZE 00A0 BYTE ! 


CONIBF SIZE (BYTE)! 
CONOBF SIZE (BYTE)! 
RINGBF & HCZBUF SIZE! 


# OF COMMAND ! 


SET FOR TRANSPARENT HDE! 

SEND COMMAND IN PROCESS! 

LOAD COMMAND IN PROCESS! 

SET KB INPUT BUFF 3/4 ! 
FULL ! 

SET IF XOFF iS RECEIVED! 
FROM KEYBOARD ! 

SET IF ESCAPE KEY HIT IN! 
UPLOAD/DOWNLOAD MODE ! 


! BIT HASK TO KEEP XON & ! 


XOFF BIT WHEN RETURN ! 
TO DEBUG ! 


1 BUFFER FOR INPUT CHAR! 


BUFFER FOR QUTPUT CHAR! 


1 KB INTERRUPT INPUT ! 


BUFFER ! 
INPUT FROM MCZ BUF ! 


! INPUT BUFFER ADDRESS ! 
! INPUT BUFFER SIZE ! 


! RAM AREA NEED TO INITIALIZE WITH FIX VALUE ! 


- | CONIBF POINTER ! 
! CONOBF POINTER ! 


102 
103 
104 
105 
106 
107 
108 
109 
110 
il 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
15t 
152 
153 


CHRDEL BYTE 
LINDEL BYTE 
XONCHR BYTE 
XOFCHR BYTE 
NULLCT WORD 
TLEGAL WORD 
TIMCNT WORD 
NL HORD 


1 
I 
1 
! 
! 
! 
! 
! 


! CHAR DELETE 


LINE DELETE 


! 
| 
! XON CHAR ! 
! XOFF CHAR I 
! NULL CHAR ! 
! ILLEGAL INSTRUC! 


COUNT FOR CTC3 ! 
BREAK & NEXT COUNT ! 


! RAM AREA NEED TO BE INITIALIZE WITH ZERO VALUE ! 


TTYPUT WORD 
TTYGET WORD 
MCZPUT WORD 
MCZGET WORD 


INST WORD 
BRKADR WORD 
RETSP WORD 
USFCH WORD 


CFLAGS WORD 


I 
! 
| 
I 
I 
| 
! 


OFFSET TQ RINGBF FOR NEXT! 
INPUT CHARACTER ! 

OFFSET TO RINGBF FOR NEXT! 
FETCH CHAR ! 

OFFSET TO MCZBUF FOR NEXT! 
INPUT FROM HCZ ! 

OFFSET TO MCZBUF FOR NEXT! 
CHAR TO QUTUT TO TTY ! 


INSTRUCTION AT BREAK ADDR! 


VALUE OF R15 | 
USER FCH FOR BREAK & NEXT! 


! BIT 1 - INHOLD ! 
! BIT 2 - OUTHLD ! 
! BIT 0 - TRANSPARENT HODE ! 


BIT 3 - SEND COMMAND IN ! 
UPLOAD/DNLOAD MODE! 


| BIT 4 ~ LOAD COMMAND IN ! 


UPLOAD/DNLOAD MODE! 
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154 RiS_ WORD 
135 PC. —s WORD 
156 SAVFCH WORD 
157 RETRY WORD 
158 

159 ! PAGE EJECT ! 

160 

161 $SECTION PRGL 

162 


163 $ABS 0 
164 
0000 165 GLOBAL MAINP PROCEDURE 
166 ENTRY 
167 
000 0000 168 WVAL =O 
0002 4000 169 WVAL = 24000 ! FCH VALUE ! 
0004 0010 170 WVAL = MSTART 1 PC VALUE ! 
171 
0006 4441 172 1 Ge 
0008 5445 173 WAL TE? 
000A 3739 174 WVAL = "79? 
0000 3231 175 WAL 721? 
OOOE 3520 176 WAL '5 
177 
178 HSTART: 
179 
180 ! GET VALUES TO CTC 2 AND CTC 1 ! 
181 
O010 8038 182 CLR R3 
0012 SAB4 183 INB RLS, SWITCH ! BIT 7-4 CHANNEL A ! 
184 ! BIT 3-0 CHANNEL B ! 
0016 A132 185 LD R2R3 1 SAVE SWITCH VALUE ! 
186 
0018 0608 187 ANDB RLS, #Z0F ! USE BIT 3-0 ! 
0010 0103 188 ADD R3, #SHTBL =! GET VALUE FROM TABLE ! 
0020 203C 189 LDB RL4, ORS ! CTC VALUE FOR CH B ! 
190 
0022 B321 191 SRL R2 #4 
0026 0102 192 ADD R2y #SNTBL 
002A 2024 193 LDB RH4, @R2 ! CTC VALUE FOR CH A ! 
194 
0020 847 195 LDB RLO, #COUNTER 
OO2E JABS 196 OUTB = CTL2, RLO ' CH B TO COUNTER MODE! 
0032 SAC6 197 QUTB = CTC2y RL4 1 SET VALUE ! 
198 
0036 3A86 199 OUTB = CTCL, RLO ! PROGRAM CHANNEL A ! 
003A 3A46 200 OUTB = CTC, RH4 ' CTCL FOR SIO CHANNEL A ! 
201 
202 1 ##8% INITIALIZE SIO CHIP xete ! 
203 
O03E 2101 204 LD Riv #INIOUT =! TABLE ADDRESS =! 
0042 2102 205 LD R2, #11 ! SIZE OF TABLE ! 
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0046 2103 
004A SAl2 


O04E 2101 
0052 2102 
0056 2103 
GO5A JAL2 


O05E 2101 
0062 7D1B 


0064 2100 
0048 2101 
0060 2162 
0070 OB0S 
0074 BOL 


0078 4005 
9070 2020 
007E 2100 
0082 2101 
0086 2102 
008A BBOL 


OOBE 2100 
0092 2101 
0076 BD28 
0098 BBOi 


OOP 2100 
QOAO 2101 
GOA4 2102 
OOAS BOL 


OOAT 2101 
OORG 6FO1 
OOB4 2101 
O0B8 4F01 
OOBC 2101 
O0CO OF01 
0004 2101 
OOCE 4FO1 
OOCT 2101 
O0D0 4F0t 
0004 2101 


OEDA 
4400 
002F 
0210 


0802’ 
4448 
SCA’ 
4406 
059A? 
4416 
0860’ 
4456 
O89E’ 
445A 
0888! 


206 
207 
208 
209 
210 
ail 
212 
23 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 


228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
247 
256 
201 
202 
253 
294 
255 


256 


LD R3, #51008 
BRI, BRiy R2 


LD Rly $4CZOUT 
Li R21 #9 

LD R3, #S10CA 
OTIRB GR, ORL, R2 


Lo Riy #4/9E00 
LUCTL REFRESH? RL 


! INIT RAM DATA ! 


RO, #24000 
Rly #24002 
R2, #4200 
GRO» #0 

BRL, BRO, R2 


CONIBF, #? ? 


RO, #CONIBF 
Ri» #CONIBF+2 
R2, #CISIZE 
GR1r RO, R2 


RO, #RAMDTA 
Ri» SINPTR 
LDK R2y #6 
LDIR = @R1» BRO, R2 


! PUT INTERRUPT ROUTINE ADDRESS IN PROGRAM STATUS BLOCK ! 


RO, $PSBLK 
Ri» #PSAREA 
R21 #47 

BRI, BRO, R2 


Rly SP TYINT 
PSKBIN» Rl 
Rly #BREAK 
PSBRKy Ri 
Riv #NHINT 
PSNNIy Ri 
Ri» #HCZINT 
PSHZIN? R1 
Ri» #CHASRE 
PSCARV, R1 
Riy #CHBSRC 


' PROGRAM SIO CH. B! 


' PROGRAM S10 CH.A! 


1! RATE = F HEX ! 


! FILL RAM WITH O ! 
! FROM 4000-4400 | 


! INIT CONIBF & CONOBF ! 


! 80 WORDS ! 


' RAM WITH FIX VALUE ! 


! PROGRAM STATUS DATA ! 
1 BLOCK DATA ADDRESS ! 
! SIZE OF TABLE IN WORD ! 


! KEYBOARD INTERRUPT ! 


| ILLEGAL INSTRUCTION FOR! 
| BREAK POINT ! 
1 NMI INTERRUPT | 


! INPUT FROM HCZ ! 
1 CH. A SPECIAL RECEIVE ! 


! CONDITION ! 
! CH. B SPECIAL RECEIVE ! 
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OOD8 6F01 


OODC 210F 
OOEO 6FOF 
OOE4 2101 
OOE8 7012 
OOEA 7005 


OOEC 


OOEL 


OOEC 2101 
OOFO 93F1 
OOF2 6101 
O0FS 0701 
OOFA 6FOL 


GOFE C830 
0100 BCCS 
0102 DCA2 


0104 2101 
0108 BD2F 
O10A BAL4 
O10E EELF 
0110 BOLE 
0112 8321 
O114 Bit 
0118 0101 
O11 2113 
OLLIE 1638 


0120 42 
0121 43 
0122 44 
0123 46 
0124 47 
0125 49 
0126 4A 
0127 4C 
0128 4D 


207 PSCBRV, Ri 
258 

209 

269 RLS, #STACK 
261 Ri5_+ RIS 
262 Rir #PSAREA 
263 PSAPOFF? Ri 
264 VI 

260 

266 

267 END MAINP 

268 | PAGE EJECT ! 

267 

270 ' MAIN PROGRAM ! 
271 

272 

273 GLOBAL EROR LABEL 

274 GLOBAL DEBUG PROCEDURE 
279 ENTRY 

276 Lo Rir #DEBUG 
277 PUSH = @R1G7 RL 
278 LD RL CFLAGS 
279 AND RL» €XHSK 
280 LD CFLAGS RL 
281 

282 

283 LDB RLOs #/X? 
284 CALR OT YHR 

285 CALR GET 

286 

287 


1 CONDITION ! 


{ SET STACK POINTER ! 


! SET PS AREA POINTER ! 


1 PUSH RETURN ADDRESS ! 
' CLEAR BIT EXCEPT XON/XOFF! 


1 GET 1 LINE INPUT/1ST ! 
! CHAR RETURN IN RLO ! 


288 ! CHECK IF COMMAND IS VALID ! 


289 Ri» @CHDTBL 
290 ‘ R2, &CMDNUM 


! COMMAND LITERAL TABLE ! 
! € OF COMMANDS ! 


291 RLO» @Ris R2y EQ 


292 NZ» EROR 
293 Rly #CHDNUH-1 
294 Ris R2 

299 Rip #1 

296 Rir EROUTBL 
297 Roy @R1 

298 RS 

299 

300 CHDTBL: BUAL = "B? 

301 BAL ’C! 

302 BVAL =’! 

303 BVAL = s’F? 

304 BVAL =s'G 

305 BAL. 2? 

406 BYAL J! 

307 BYVAL 'L? 

508 BVAL =H? 


1 INVALID COMMAND ! 


! INDEX TO ROUTINE TABLE ! 


1 GET ROUTINE ADDRESS ! 


0129 4£ 
012A 50 
0128 St 
0120 32 
O12) 33 
O12E 34 
O12F 54 


9130 0454’ 
132 ODE’ 
0134 0210? 
0136 O19! 
0138 O4BA 
N13A 09BC! 
O15C O4AC’ 
O13E OAB4’ 
0140 01C0’ 
0142 0510! 
0144 OAQA’ 
0146 O1SE’ 
0148 O30E? 
O14A OB34! 
O14C OA4E? 


O14E CB3F 
0150 DCEE 


0152 G10F 43F4 
0156 4D05 4384 
O1SA 4130 
150 E807 


309 


335 | HO HHBBHOBHHEEHBHHHAHEGHUHO EHH EBB BBE HEE GBHEE [ 


310 BVAL =P? 

311 BVAL =’? 

312 BVAL = /R? 

Hg BVAL =—'#9? 

314 BVAL = 'T? 

315 BVAL = /T? 

316 

317 

318 

319 ROUTBL! WVAL = BRKPNT 
326 WVAL COMPARE 
321 HVAL DISPLAY 
322 WVAL FILL 
323 HVAL = GO 

324 WVAL —- TOPORT 
325 HVAL = JUHP 
326 WAL = LODCHD 
327 WVAL = - HOVE 
528 HVAL NEXT 
329 WVAL PUNCH 
330 WVAL = QUIT 
331 WVAL ——- REGISTER 
332 WVAL SEND 
333 WVAL TAPE 
334 

330 

337 ! 

338 ! 

339 ! 

340 ! 

341 

342 EROR: 

343 LUE RLOy #7 
344 CALR —TYHR 
345 

346 LD R15, R1D_ 
347 LD 

348 JR DEBUG 
49 


350 END DEBUG 

Soi ! PAGE EJECT ! 

352 

353 GLOBAL QUIT PROCEDURE 
354 


! NEXT INST. AT EVEN ADDR! 


EROR RESET STACK POINTER, PUT QUT ? & JUMP TO DEBUG 


1? PUT ? FOR ERROR 
! RESET STACK PTR 


JORHOBHGHHBB HEHE IEHEBOBOHHOHBBBH BABE O BEBE BEHHBHBAHEE 1 


QUTFTR» #CONOBF ! RESET CONOBF POINTER ! 
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355 | 3H EEE HEEB HEE EGHEHHEHE | 
356 | 
357 
358 


1 QUIT ENTER THE TRANSPARENT MODE. ALL CHARACTERS 
1 ARE PASSED BETWEEN THE HCZ & THE TERMINAL. 
359 ! FIRST CHECK ANY CHARACTER FROM TERMINAL » THEN 
360 ! X/MIT CHARACTERS TO MCZ UNTIL A CARRIAGE RETURN IS ! 
361! RECEIVED. AFTER THE CARRIAGE RETURN IS TRANSHITTED ! 
362 ! TO MCZ» CHECK ANY CHARACTER FROM MCZ FOR OUTPUT TO 
363 ! TERMINAL, KEEP QUTPUT CHARACTER TO TERMINAL UNTIL 
364! HCZ BUFFER IS EMPTY, THEN CHECK ANY INPUT FROM CRT. ! 
365 ! 
366 | 
367 
368 ENTRY 
O1SE 4008 369 HCZPUT 
0162 4008 370 MCZGET 1 RESET MCZ INPUT BUF PTR! 
0166 6500 371 CFLAGS, #TRNMDE ! ENTER TRANSPARENT MDE! 
372 CRTIN: 
O16A 6100 373 RO» TTYGET ! GET INPUT FROM TTY ! 
O16E 4800 374 RO» TTYPUT 
0172 £608 375 Z, HCZIN 1 NO TTY INPUT ! 
376 
0174 SFO0 377 GBFADR 
0178 dF00 378 TTYGET? RO 


J8HE BBB HEB HHH BEBE HEEB BEEBE EBB | 


! GET ADDRESS OF RINGBF ! 
! UPDATE POINTER ! 


O17E SFO0 380 MCZSND 
0182 EEF3 381 NZr CRTIN 
382 
383 
384 MCZIN: 
0184 6100 385 RO, HCZGET =! GET INPUT FROM MCZ ! 
0183 4800 386 RO» MCZPUT 
180 E4EE 387 Z1 CRTIN ! NO MCZ INPUT, GO & CHECK! 
388 1 TTY ! 
O1BE SF00 38? HCZADR ! GET ADDRESS OF MCZBUF ! 
0192 4F00 390 MCZGET» RO 
0196 2028 391 RLO» @R2 ! GET CHAR FROM MCZ ! 
0198 SFO0 392 TYHR 1 & SEND TO TTY ! 
O19C ERF3 393 MCZIN | KEEP X’MIT DATA TO TTY ! 
394 1 UNTIL MCZBUF IS EMPTY! 
395 
O19E 396 END QUIT 
397 | PAGE EJECT ! 


& SEND TO MCZ ! 
| KEEP X’MIT DATA TO HZ ! 
! TILL CR RECEIVE FROM TTY! 


1 
I 
0170 2028 379 RLO, @R2 ! GET CHAR FROM TTY ! 
| 
! 
| 
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O17E DC4B 
O1A0 E704 


O1A2 A750 
O1A4 SEOE 
O1A8 8354 


O1AA 5E07 


O1AE B341 
0182 2F53 
O1B4 904 


O1B6 A153 
O1B8 A931 
O1BA BBS1 
OLBE 9E08 


0100 


O14E 


O14E 
FFFF 


3 
399 GLOBAL FILL PROCEDURE 


400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
4il 
412 


| OHBHBHBHHHBDHEBEHEHIOHHEBHEB HH BHHAHHEIB HAHEI EHEH EB BBEE 


FILL STORES GIVEN DATA (WORD) INTO SPECIFIED MEMORY 
SPECIFIED ADDRESS HUST BE EVEN 


EXIT: JUMP BACK TO DEBUG, IF FOUND SYNTAX ERROR 
RETURN TO DEBUG FOR NORHAL RETURN 


! 
! 
! 
! 
! 
! 
! 
| 
| 
| 


JAH HHHHB BHR HEBHEBBBBEHIBBHEHBHBBHHEHHBBSHBHHBHEBHBEE 


413 ENTRY 


414 
415 
416 
417 
418 
AL? 


LODS ! GET 3 ARGUMENT ! 
C1 CEROR ! NOT ENOUGH PARAMETERS ! 


RS, #0 1 CHECK FOR EVEN ADDR =! 
NZ» EROR 
R4iR5 ! ADDRESS2 - ADDREESS1 =! 


420 CEROR: 


421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 


SYNTAX! FILL (BEGINNING ADDR) (ENDING ADDR) <DATA)! 


! 
! 
! 
! 


C1 EROR ! ERROR» ADDRESS2 TOO SHALL! 


R4, #1 ! FILL BATA IN WORD ! 
BRS» RI ! STORE DATA IN 1ST WORD ! 
Z ! R4-RG=0/JUST FILL 1 WORD! 


Ray RO ! NEXT MEMORY ADDRESS =! 

R3r #2 

GR @RO, R4 ! DUPLICATE MEMORY CONTENT! 
! RETURN TO DEBUG ! 


433 END FILL 


434 
435 


436 
437 GLOBAL MOVE PROCEDURE 


438 
439 
440 
At 
449 


443! 


444 


445 ! 


446 


447 | 
448 ! 


449 


| GEH698 1H 1G1HG IHU SEBEL 
) HOVE TRANSFER BLOCK OF DATA FROM ONE MEMORY TO 
1 ANOTHER IN BYTE ! 
7 SYNTAX: MOVE (SOURCE ADDR) (DEST. ADDR) N 
! EXIT: RETURN TO DEBUG ! 
! ! 


JABHHEBHHBBHHHHBHEEHA HAHAH HEEHB BB EBEHHHBHE 


483 


450 ENTRY 
OiCd DC79 491 LOD3 ! GET 3 ARGUMENT ! 
492 1 RO=SOURTE ADDR. R4=DEST. ! 
0102 E7F3 433 CCEROR ! NOT ENOUGH ARGUMENT ! 
0104 AlS6 454 Rér RS ! CHECK DIRECTION TO HOVE! 
0106 8346 499 Ror R4 
01CB £703 496 C» MOVEUP 
O1CA BASL 497 @R4r ORSr RI 
O1CE 9E08 458 
459 
0100 8135 460 HOVEUP: ADD 
O1D2 ABSO 461 
O1D4 8134 462 ADB 
0106 AB40 463 DEC 
O1D8 BAS? 464 LDDRB = @R4y @RSy RS 
OLDE 9E08 465 RET 
O1DE 466 END MOVE 
467 
468 
OLDE 449 GLOBAL COMPARE PROCEDURE 
470 


471 
472 
473 
474 
475 


1 38H0813300E00 1209008000 BEEBE EB BEE | 
! 
! 
! 
I 
476 ! 
! 
! 
! 
! 
! 


COMPARE THO BLOCK OF MEMORY AND DISPLAY THEIR 
CONTENTS IF THEY DON’T HATCH. N IS THE # OF BYTE 
TO COMPARE. 


477 
478 
479 
480 
481 
482 
483 ENTRY 

OiDE DC8B 484 LOD3 1 GET 3 ARGUMENT ! 

OLEO E7E4 485 C/CEROR ! NOT ENOUGH ARGUMENT ! 

O1E2 A156 4B6 1 ADDR 1 ! 

O1E4 A148 487 1 ADDR 2 ! 

O1E6 A137 488 ! # OF BYTE ! 

OLE8 8034 489 

O1EA 5SE06 490 
491 

O1EE 2069 492 REPTS: LDB RL1y @R6 ! CONTENTS OF ADDR i ! 

O1FO BAGO 493 CPIB = RLLy @RB» R7VEO 

O1F4 £606 494 JR Zs NXTSS 
495 

O1F6 A165 4% LD Ro» Ré 

O1F8 DFF8 497 CALR —-PDIFF ! PRINT DIFFERENCE ! | 

O1FA A185 498 LD Rov RB 

OLFC ABSO 499 DEC RS 

O1FE DFFB 500 CALR —-PDIFF 

0200 D044 501 CALR = PUTPTR 


SYNTAX: COMPARE <ADDRi>) <ADDR2) N 


! 
! 
! 
| 
! 
! 
! 
EXIT: =RETURN TO DEBUG | 
I 
! 


39873 3 A 
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0202 8174 
0204 9E06 
0206 A960 
0208 E8F2 


020A DESD 
020C 2101 3020 
0210 DEE? 
212 2050 
0214 DC70 
0216 6901 
021A JEOB 


0210 


o2ic 


O21 DDSB 


O21E 8038 
0220 2107 0202 


0224 EE02 
0226 AL3B 


302 


903 NXTSS: 


904 
905 
304 
507 
508 


! CHECK IF ALL DONE ! 
' NEXT HEHORY ! 


509 PDIFF: 


10 
Sit 
12 
313 
214 
a15 
o16 
S17 


QUTPTR, #2 =! ADD SPACE ! 


918 END COMPARE 
51? | PAGE EJECT ! 


520 


O21 GLOBAL DISPLAY PROCEDURE 


522 


923 | 8HHHHHHHHHHBEBB EHH BHHHEHHBHEHH SHAH HEB HEHEHE BHBEBEBHBE 


! 
! 
! 
! 
i 
| 
I 
I 
| 
| 
i 
! 
! 
! 
! 


1 
! 
DISPLAY CONTENTS OF MEMORY AND ALSO ABLE TO ALTER ! 
TTS CONTENTS. IF <COUNT) IS GIVEN, 16 BYTES OF ! 
MEMORY ARE DISPLAYED ON ONE LINE» WITH SPACE BETWEEN ! 
BYTE OR WORD OR LONG WORD DEPENDING ON THE LAST ! 
PARAMETER. IF (COUNT) IS NOT GIVEN, MEMORY IS GIVEN ! 
IN ONE BYTE/WORD/LONG WORD. NEW VALUE CAN BE ENTERED ! 
OR CARRIAGE RETURN WILL ADVANCE TO NEXT MEMORY. ! 
COMMAND Q IS USED TO EXIT ! 
I 

i 

I 

I 

| 

| 

I 


SYNTAX! DISPLAY (ADDRESS) C(COUNT)] CLIWiBI 


EXIT: IF /Q’ 1S RECEIVED, RETURN 70 DEBUG 
IF ANY ERROR IS FOUND, JUMP TO ERROR 


JHHHHOBBHHHBHEBBEB HB HBBBBB BBE HHEHBHEHEHHHHHBBEHBEHIE 


O41 ENTRY 


42 
943 
344 
945 
546 
347 
48 
347 
300 
351 
Ju2 
593 


1 IF NO INPUT AFTER DISPLAY COMMAND, DEFAULT TO ! 
! DISPLAY MEMORY ONE WORD AT A TIME STARTING AT ! 
! ADDRESS 0 ! 


CALR =—-NXTARG ! SKIP OVER COHMAND =! 

1 RETURN RLO=NEXT CHAR! 
CLR R3 ! DEFAULT USE ADDRESS 0 ! 
LD R71 #2202 


JR NZ+ NOTCR ! THERE IS ARGUMENT ! 
uD Riis R3 ! GOT CR» DISPLAY ONE AT! 


485 


486 


0228 EB3B 


022A DD8S 
0220 AL3B 
022E £638 


0230 DFAD 
0232 £636 


0234 DD8A 
0236 AL3D 
0238 £602 


023A DFB2 
0230 EEBB 


023E 84 
0240 £684 


0242 2109 
0246 ALBS 
0248 DC8C 
024A 6900 


O24E 2108 
9252 0C85 
0256 ABO 


304 
doo 
996 
597 


JR ONEMEH 


1 A TIME ! 


! CHECK ANY ARGUMENT FOLLON DISPLAY COMMAND & SPACE ! 


508 NOTCR: CALR  GETADN 


50? 
960 
361 
362 
963 
964 
369 
366 
567 
568 
569 
370 
S71 
972 
73 
574 
975 
976 
977 
978 
079 
380 
381 
2B2 


583 


384 
985 
586 
387 
88 
989 
970 
371 
392 


LD Riis R3 
JR Z » ONEHEX 


! NEXT ARGUMENT AS ADDR! 
1 SAVE HEMORY ADDR ! 

1 GOT CRr DISPLAY ONE AT! 
1 A TIME ! 


! NEXT ARGUMENT CAN BE (COUNT) OR (LiWiB) OR (CR) ! 
! IF (CR) IS RECEIVED, DISPLAY MEMORY ONE AT A TIME ! 


1 IN WORD ! 


CALR = CKWBL 
JR Zr ONEHEH 


! CHECK NEXT ARGUMENT =! 
1 NO COUNT»RECEIVE LiWiB! 
! DISPLAY ONE AT @ TIME! 


1 NEXT ARGUHENT IS NOT (H/L/B) OR (CR), IT MUST BE ! 
! COUNT. THE VALUE OF COUNT MUST ) 0 ! 


CALR —- GETADN 
LD R13, R3 
JR Zy LINELP 


! NEXT ARGUMENT MUST BE ! 
1 COUNT | 

! RETURN Z MEANS CR ! 

! AFTER COUNT, DEFAULT ! 
! TO DISPLAY WORD ! 


! RECEIVE ADDR & COUNT, NEXT ARGUMENT CAN BE LiWiB ! 


OR (CR). ! 


CALR = CKWBL 
JR NZ1 EROR 


1 GET (HIBIL) OR (CR) | 
! SYNTAX EROR ! 


! PRINT MEMORY, 16 BYTES PER LINE WITH CORRESPONDING 
1 ASCIT CHARACTERS. R? = # OF BYTE PER LINE (14) 


R13 = ( COUNT ) Ril = ( ADDRESS ) 


! 
! 
! RH7 RL? = & OF BYTE PER SPACE (1/2/4) ! 
| 
| 


| 
' RB = CONOBF ADDRESS FOR PRINTING ABSOLUTE VALUE 


593 LINELP: 


394 
395 
996 


Rig 
Zr EROR 


597 NXTLNE: RO» #16 


398 
399 
600 
601 
602 
603 
604 
605 


Ror Ril 
PUT2 
OUTPTR 


RB, #CONOBF+S3 
GRE, #7 x! 
RB 


! BYTE PER LINE ! 
! CONVERT ADDR TO ASCIT! 
1! CHAR. & STORE CONOBF! 


0258 2080 606 PUTLP: LDB —RLSy BRIA ! GET HEHORY CONTENT 
025A 2680 607 BRB, RLS 1 ABS VALUE IN BUF 
0250 OAOD 608 RLS #!? | CK IF PRINTABLE 
0260 £703 409 Cy NOPRNT 
0262 OAOD 610 RLS #27F | ONLY ALLOW 7 BIT VALUE! 
0266 £702 éli Cy PRNT 
0268 OCBS 612 NOPRNT: LDB R27, ! PLACE HITH . 
413 
0260 A980 614 PRNT: INC RB, #1 | ADVANCE BUF ADDR 
026E OCB5 6i5 LDB GRO, eH | INCASE OF END | 
0272 DCOF 616 CALR PUT! 1 CONVERT VALUE IN RS ! 
417 1 TO ASCII&STORE CONOBF! 
0274 A9B0 618 INC RIL #1 | ADVANCE HEMORY ADDR ! 
419 
0276 ABO 620 R9 
0278 EE08 621 JR NZ» ‘CKSP | CHECK IF FILL UP LINE ! 
027 A9B0 622 INC RB 
0270 6F08 623 LD = QUTPTR» R@.—s! «END OF BUF ! 
0280 DCBS 624 PUTPTR | YES? PRINT LINE 
0282 A07F 625 RL7»RH? | RESTORE # BYTE/SPACE ! 
626 R13, NXTLNE «CK IF ALL DONE 
0284 ABDO 627 DEC RIS 
0286 EEDD 628 JR NZ» ‘NXTLNE 
629 
0288 9E08 630 RET 
431 
028A FFIA 632 CKSP! DBUNZ —RL7/PUTLP | CK IF NEED PUT SPACE ! 
028C 4900 633 INC QUTPTR 
0290 A07F 634 LDB —RL7»-RH7 | RESTORE # BYTE/SPACE ! 
635 IDINZ R13 » PUTLP IF NOT DONE, CONTINUE ! 
0292 ABDO 636 DEC RIB 
0294 EEE! 437 JR NZ» PUTLP 
638 1 SAE LINE 
0296 A980 639 INC RS 
0298 6F0B 640 LD so OUTPTR» R@ =! END OF BUF ! 
0290 DC? bat CALR —PUTPTR 
029 9E08 642 RET 
643 | RETURN TO DEBUG 
644 
645 
646 | PRINT HEMORY ONE AT A TIME IN BYTE/HORD/LONG WORD! 
647 | RY, RAL = MEMORY ADDRESS ! 
648 | RH7y RL7 = & BYTE/SPACE (1/2/4) 1 
649 
020 ALB? 650 ONEMEN: LD RO RIL 1 SAVE ADDR FOR STOREING! 
02A2 ALBS 651 LD RS RAL | CONVERT ADDR TO ASCII! 
0244 DCBA 652 CALR —PUT2 | CHAR & STORE CONOBF ! 
02A6 6900 4386 653 INC OUTPTR | ADD SPACE ! 
654 


02AA 20BD 695 MORE: LDB RLSy @Ril ! GET MEMORY IN BYTE ! 
O2AC DCBC 656 CALR = PUTL ! CONVERT THO 4BITS ABS! 


487 


488 


O2AE AYBO 


02B0 FFO4 
02B2 6900 
02B6 AQ7F 


0288 DFDY 


02BA 9E07 
O2BC E4F1 


O2BE AAFO 
0200 EE02 
022 2E9B 
0204 E807 


0206 AAFO 
0208 EEO2 


657 
658 
699 
660 
661 
662 
463 
464 
665 
666 
667 
668 
669 
470 
671 
672 
673 
674 
675 


RET 
JR 


! VALUE TO THO ASCII ! 
Ril, #1 ! INC MEMORY ADDR BY 1 ! 


RL71 HORE ' CK IF PRINT BiniL =! 
OUTPTR» #1 ! ADD SPACE } 
RL71 RH? ! RESTORE # BYTE/SPACE ! 


PGET ! PRINT CONOBF GET INPUT! 
! INTO CONIBF » TRANSLATE! 
' INPUT TO DOUBLE WORD! 
| 


HEX VALUE IN R2/R3 ! 


C ! RECEIVE QUIT ! 
Z) QNEHEN ! RECEIVE CR» ADVANCE TO! 
1! NEXT LOCATION ! 


! RECEIVE VALUE FOR MEMORY, CHECK EITER REPLACE ! 
1 CONTENT WITH VALUE IN LONG WORD OR WORD OR BYTE ! 


DECB 
JR 
LOB 
JR 


DECB 
JR 


RL7 
NZr CKHL ! CHECK INPUT BiWiL ! 
ORI» RLS ! NEW BYTE CONTENT ! 
SRT 


RL? 
NZ, CKW 


020A 2°93 
020 E803 


O2CE 2F92 
0200 A991 
0202 2F93 


0204 A07F 
0206 E8E4 


0208 


0208 


0208 2107 
02DC OA08 
Q2E0 9E06 


02E2 0A08 
Q2E6 9E06 


Q2E8 2107 
O2EC OA0B 
02F0 £06 


Q2F2 2107 
02F6 OA0B 
O2FA 9E06 
O2FC 2107 
0300 9E08 


0302 


683 
484 
685 CKH: 
686 
687 
688 
489 SRT: 
490 
691 
492 


GRP, RI 
SRT 


ORI, R2 
RD, #2 
ORI, RI 


RL7, RH? 
ONENEH 


693 END DISPLAY 
594 


699 


696 GLOBAL CKWBL PROCEDURE 
697 


! NEW WORD CONTENT ! 


! NEW LONG WORD CONTENT! 


' RESTORE #BYTE / SPACE! 
! NEXT LOCATION ! 


498 | GHOHHHBHBHHBEBBHEHEHEBBHHHBHRUHBBBOABEHHEHBHBBABHHBES | 


699 ! 


700 ! CKWBL CHECK THE CHARACTER IN RLO WHETHER IT 1S 'W’ OR 
701 | 7B’ OR ’L? OR CARRIAGE RETURN, THEN SET # OF BYTE TO 
702 ! PRINT SPACE IN RH?» RL7 


703 
704 
705 
708 


i} 

1 INPUT : 

1 
707 | 

l 

1 


OUTPUT: 


708 
709 
710 
7il 
712 
713 
714 ENTRY 


732 END CKHBL 
733 
734 


RLO = CHARACTER 


RET Z & R7 = ZOL0L 
RET Z & R7 = 20202 
RET Z & R7 = 20404 
RET NZ & R7= £0202 


R7» #2202 
RLO» #ASCICR 
Z 


RLO»r #/h? 
Z 
R71 #/101 
RLO» #°B? 
Z 


R7> #4404 
RLOy #/L? 


Z 
R77 #4202 


IF RECEIVING B 

IF RECEIVING (H) OR CR 
IF RECEIVING L 

IF RECEIVING CHARACTER 
OTHER THAN ABOVE 


139 9 0 9 EE 


! DEFAULT IS 2 BYTE/’ ? ! 
! RECEIVE CRr USE WORD ! 


' CK FOR W 
1 RECEIVE W ! 


! GET Ri TO 1 BYTE/? ? 
! CK FOR B 
! RECEIVE B ! 


! SET TO 4 BYTE 
{CK FOR L 
! RECEIVE L ! 


! NOT CR» WiBiL 


! 
! 
! 
! 
! 
! 
! 
I 
| 
! 
! 
| 
! 
| 
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735 GLOBAL PGET LABEL 
736 GLOBAL PRTGET PROCEDURE 


| 8HHHHEHBEHB HBB BEEBE BEEBE BEBE EB HBHEBHBBHBBE 1 


! PRIGET CONVERTS RS TO FOUR 8-BITS ASCII CHARACTERS 
! AND STORE THEM IN CONOBF, THEN PRINT CONOBF WITHOUT 
! CARRIAGE RETURN. FETCH NEXT INPUT LINE AND STORE 

! THEM IN CONIBF, CONVERT 8 INPUT ASCII CHARACTERS TO 
1 8 HEX VALUE INTO R2.R3 


RETURN C FOR RECEIVING 'Q/ 
RETURN NC» Z FOR RECEIVING CARRIAGE RETURN 
RETURN NCoNZ FOR RECEIVING INPUT WITH CR 


1 HH ROPRLR2/RI/RA ARE LOST ss 


I ! 
| ! 
| I 
! i 
| i 
r | 
! ! 
! QUTPUT: R2.R3 = EIGHT 4-BITS HEX VALUE ! 
I ! 
i l 
! | 
I ! 
I ! 
| ! 
! I 
I ! 


{OHHHHBHBBHHHB HEHE BBEBHBHHHHHBHHHB HHA EBB BHBHHE | 


736 ENTRY 

0302 DCE? 737 CALR = PUT2 ! PUT RO INTO CONOBF ! 

0304 6900 4386 © 758 INC = QUIPTR» #1 «=! -PUT SPACE AFTER ! 

0308 DCC4 759° PGET: CALR  PUTNCR ! QUPUT TO TTY W/O CR ! 

O30A SEO8 0656’ 740 JP GETNUH ! GET INPUT IN R2-R3, RET! 
761 

O30E 762 END PRIGET 
763 ! PAGE EJECT ! 
764 

O30E 765 GLOBAL REGISTER PROCEDURE 
766 
767 | J8BBHEHEHHHEH HHH HH HBHHEE HEEB HEEB BEEBE 
768 ! ! 
769 | REGISTER COHHAND DISPLAYS CONTENTS OF USER REGISTERS. ! 
770 |! USER IS ABLE TO ALTER ITS CONTENT. IF NO REGISTER NAME! 
771! IS GIVEN, ALL REGISTERS WILL BE DISPLAYED IN WORD.  ! 
772 | IF REGISTER NAME I$ GIVEN»NEW VALUE OR CARRIAGE RETURN! 
773! CAN BE ENTERED AFTER THE CURRENT VALUE, THEN ADVANCE ha 

NEXT REGISTER, 


| 
I 
| 
! 
i 
| SYNTAX: REGISTER (REGISTER NAHE) 
! 

| EXIT: IF @ COMMAND IS ENCOUNTERED, DIRECT JUMP BACK To! 
DEBUG, FIX STACK 

IF ERROR 1S FOUND, DIRECT JUMP BACK TO DEBUG |! 
QUTPUT 12? AND FIX STACK 
1 { 
| | 


{HHBHBHHHBHHBHEHHBBHHHHEEBHBHHEHHBBHHEHBRHEHHBEBHEEEE | 


785 ENTRY 
O30E ODES 786 CALR = NXTARG ! SKIP OVER COMHAND 
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0310 5E06 
0314 6A08 
0318 EE1D 


OS1A DDBB 
Os1C E600 
O31E AOBE 
0320 0A08 
0324 E608 
0326 8068 
0328 9A08 
0320 £604 
Q32E C402 
0330 0A08 
0334 EEO3 


0336 DDCé 
0338 E06 


O33 A081 
O33E DDCA 
0340 EE02 
0342 C920 
0344 £801 
0346 A089 


0348 2108 
O34C 2109 
0350 BB94 
0354 SEOE 
0358 ABY1 
O35A 2102 
O35E 8382 
0360 A128 
0362 B3B1 


0366 OAOE 
036A £444 


787 
788 
789 
790 
791 
792 
793 
794 
79) 
796 
797 
798 
799 
800 
B01 
802 
803 
804 
805 
806 
807 
808 
B07 


JP 2 RALL ! HIT CReNO NAME*FRINT ALR! 
CPB RLO, #/R’ =| TF NAHE ENTER, HUST BE R! 
JR NZ ERNZ 1 ERROR ! 


CHECK REGISTER NAME FOR RR/RH/RL/R/ ! 
RL6 = 'L? OR 7H! OR 'R! ORF ! 
RH4 = 0 IF INPUT 15 ’RL? OR 2 IF INPUT IS ’RH’ 


CALR GCHAR =! GET NEXT CHAR | 

JR Z, ERSS 1 ERROR TO RECEIVE CR! 
LDB RLé, RLO 1! SAVE 1ST CHAR (ReLiHr#) ! 
CPB RLO, #/R’ =! «CK IF DOUBLE REGISTER ! 
Jk Z> GDIG ! YES, GET REG # ! 
CLRBORH6 ! RH6=0 FOR RL# | 
CPB RLO, #7L’ ss !:- CK LOWER BYTE REGISTER! 
JR Z, GDIG 1 YES, GET REG # ! 

LDB RHér #2 ! RH6=2 FOR RHE! 

CPB RLO, #7H? = !_- CK UPPER BYTE REGISTER! 
JR NZ SAVL ! NOJRECEIVE WORD REG. NAME! 


1 FETCH NEXT 2 CHARACTERS IN Ri FROM CONIBFsFILR 2ND! 


810 GDIG: 
B11 ERSS: 


812 


813 SAVL: 


814 
815 
816 
B17 


B18 SAV2: 


819 
820 
821 
822 
823 
§24 


CHARACTER WITH BLANK IF ONLY RECEIVE ONE CHARACTER! 


GCHAR ! GET 1ST CHAR OF REGNAHE ! 
Z1 EROR 1 CAN’T BE CR ! 


RHis RLO ! SAVE 1ST CHAR OF REG NAME! 
GCHAR ! GET 2ND CHAR FOR REG NAME! 
NZ SAV2 1 SAVE 2ND CHAR ! 

RUT EP 2h) CRUD ESTP AIT Ch! 

CKNAHE 

RLir RLO ! BOTH CHAR IN Ri ! 


CHECK REGISTER NAME IN Ri AGAINST REG LITERAL TBL! 
IF FOUND HATCH: THEN ! 

R9 = PTR OF REG LITERAL TABLE WHICH MATCH THE NAME! 
RB = OFFSET TO REG CONTENT ARRAY =! 


825 CKNAME: LD RB, #18 1 TOTAL 18 REG NAMES ! 


826 
827 


828 ERNZ: 


B29 
830 
831 
§32 
833 
834 
835 
834 
837 
838 


Rr #LRO ! ADDR OF REG LITERAL TBL! 
R1,BR9/RBEQ !LOOK FOR HATCH ! 
NZ1 EROR 
R9, #2 ! BACK UP TO CORRECT ADDR! 
R2r817 ! CONVERT REMAINING COUNT ! 
R2R8 ! TO REG MEMORY CONTENT ! 
RB, R2 | OFFSET ! 

SLL RB, #1 


DETERMINE WHAT TYPE OF REGISTER TO DISPLAY ! 


CPB Riér #7H’ = !s-RLO = H/L/R/E ! 
JR Z HALF 
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S360 OAQE 4C40 = 839 CPB RL4y #°L! 
Os70 Eb4t 840 df 2) HALF 


0372 GAQE S252 B41 CFB RLé, #/R? 
G376 E618 842 Jk Zr BHORD 
843 
a44 i DISPLAY WORD REGISTER. =! 


845 RG = OFFSET TO REGISTER CONTENTS | 
644 I RY = POINTER TO REGISTER LITERAL TABLE ! 
647 
0378 2101 5220 848 RWORD: LB Rly #/R 
0370 LFF 849 CALR = STRROL 
O57E 6BO0 4386 © 850 PEC = QUTPTR: #100! PRINT ONLY R | 
0382 2191 Bol Li fii» GRY ! PRINT REG NAHE | 


0384 EFAS a52 CALR  STRRGL 
0566 8500 4784 = 853 INC = QUTPTR» #10} SPACE AFTER NAME | 
O38A 4185 4306 © 854 LB RGy RO_(RB) | GET CONTENT | 
859 
Q3GE 1047 856 CALR = PRTGET 1 STORE RS IN CONGBF GUTPUT! 
857 1 CONOBF EXPECT INPUT IN } 
858 a 
0390 FE07 809 RET oC ! RECEIVE Q/RETURN TO DEBUG! 
0392 £407 866 Jk 2, NOINPUT =} RECEIVE CR» NO INPUT ! 
Boi 
0394 2192 842 LD Re ORY ! TF CHANGE PC, INPUT BE! 
0374 9802 5043 643 CF R21#/FC! ! BE EVEN NUMBER ! 
O39A EEOL 844 JR NZ sNOTPC 
O37C ASSO Boo RES RG #0 
846 NOTPE: 
GOVE aF83 4306 == 567 LB RO_(R)» RI! REPLACE WITH NEW VALUE | 
848 NOINPLIT: 
G3A2 A981 869 INC = RB, #2 1 OFFSET+2 FOR NEXT CONTENT! 
O3A4 APL 876 INC = RY, #2 ! PTR TO NEXT LITERAL | 
O3A6 OBOP OESF = B71 CF Ror #LFC+1 =} DONE IF ADDR OF REG LIT. ! 
OSAA EVES 872 JR Cy RWORD | BEYOND THE TABLE ! 
GSAL SE08 873 RET {RETURN TO DEBUG | 
874 
875 | BISPLAY DOUBLE WORD REGISTER/REGISTER NAME HUST BE! 


876 1 EVEN €) R= OFFSET TO REGISTER CONTENTS ! 
877 | RPSPOINTER TG REGISTER LITERAL R1=REGISTER NAME | 


878 
OSAE CRO? OE9A 879 BHORD: CP Roe #LRL5 1 ONLY 0-14 (EVEN) ! 
O3B2 EF22 880 Jk NC, E0R 1 CAN'T BE POPC ! 
0384 GAO? 2020 B61 CPB) tiRLiy $! ? ! CHECK IF 0-9 } 
O3B8 E402 882 JR Z: thi 1 YES, CHECK iST CHAR ! 
Q3RA A710 853 BIT = Rly #0 | CHECK 2ND CHAR IF EVEN ! 
O3BC E801 884 JR NX 
OSBE A718 885 Chit BIT Rhy #8 ' CHECK 1 CHAR IF EVEN ! 
0300 EEC9 886 Nx: JR NZs ERNZ 1 ERROR FOR ODD REG NAME ! 
887 
302 2101 5252 888 DOUBL: LD Ri» €/RR! 
9306 DFC4 BEF CALR  STRRGL 
O3C8 2191 870 Li Ris BRY ! PRINT REG NAHE ! 


492 


030A DFS 891 ¢  STRRGL 
O3CC 4700 892 QUTPTR: #1 = | PUT SPACE ! 
0300 6185 393 RS» RO(RB) «=! LOAD CONTENT OF iST WORD ! 
0304 DDS2 BF4 PUT? 
895 
03D6 6185 894 LE R5y RO_+2 (RB) 
897 
030A [06h 898 “ALR = PRIGET 1 STORE RS, OUTPUT CONDBF! 
899 ) & EXPECT INPUT IN R2,R3! 
O3NC 9E07 900 ET of ! RECEIVE G/RETURN TO DEBUG! 
Q3IE £694 901 Z NOIN : RECEIVE CRy NEXT MEMORY! 
O3E0 OF 82 502 RO_(RB}, R2 | REPLACE NEW CONTENTS ! 
QO3E4 FBS 903 i RO_+2 (RB) » RI 
504 
G3EB AGES 905 NGIN: RB, #4 | OFFSET+4 NEXT DOUBLE REG ! 
Q3EA AIS 904 Ro, #4 ! POINT TO NEXT REG LITERAL! 
GJEL OB09 507 , R9, 4LRiGe1 9! DONE IF ADDR OF REG LIT! 
03F0 E7E8 908 ( Cr BOUBL 1 REACH SP : 
O3F2 9E08 509 ! RETURN TO DEBUG ! 
710 
Fil | HALF DISPLAY BYTE REGISTER, REG NAHE 0-7 ONLY ! 
912 (R83 = OFFSET TO REG CONTENT RHO = 0 FOR Ly 2 FOR H! 
13 1 RF = POINTER TG REG LITERAL ! 
914 
Q3F4 OO? 515 F RPy #LRB : CHECK IF REG 7 ! 
Q3FB SEOF 914 NC, EROR 
P17 
O3FE B3éL P18 Ror #8 1 R6 = 0 FOR L? 2 FOR YH ! 
719 
£400 EEOL 920 t NZy SAMR NING ADDR IF LOW ADDR ! 
0402 A9B0 921 Ro 
922 
923 
$464 éioi OEAG = F728 Rir LIT(R6) ! GET RL? OR TRH? | 
0408 DFES 925 ALR | STRRGI 
G40A 2191 926 i Ri» QR? 1 REG NAHE ! 
0400 DFE? 927 “ALR | STRRGL 
G40E 08H 926 ) RLS) RO_(R8) | GET REG CONTENT ! 
O42 DDAF 929 ALR PUTL 
414 6700 >  QUTPTR 
O416 D087 FGET ! QUPUT & INPUT IN Raeko | 
Gata £0? P32 : c | RECEIVE G@ RETURN TO DEBUG! 
O40 £592 3 . Z> NINP 
O4i€ 6E8B 4 RO_(RB)» RL3 | REPLACE WITH NEW VALUE! 


G422 APEO b NO ORG 1 Bi ! OFFSET TQ NEXT HYTE REG! 

0424 ABSI 937 C Re r#2 1 ABVANCE TO NEXT REG ! 

426 ESeE Zr SAMR 1 PRINT LONER BYTE OF SAME! 
REGISTER ! 


0428 2106 740 Ro: #2 
0420 ASPL 5 R9, #2 ! NEXT REG LITERAL ! 
O42E O80? 742 , RF» $Lk8 ! GONE IF ADDR OF REG ! 
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0432 E7E8 943 Jk Cy SAM ! LITERAL REACH R6 
0434 E08 944 RET ! RETURN TO DEBUG ! 
945 
946 
947 COMMAND WITHOUT REGISTER NAME ! 
948 ! PRINT REGISTER 0-15, FC, FCK ! 
249 
950 RALL: 
0436 DDAS 951 CALR RHEDL ! PRINT REG 9-15 HEADER : 
0438 DDY3 952 CALR PUTRGL | AND CONTENTS ! 
953 
043A DD89 954 CALR RHED? ! PRINT FCK, PC HEADER 
955 ! AND CONTENTS ! 
0430 SEOE 956 JP PUTRG? ! THEN RETURN ! 
957 
0446 956 ENT REGISTER 
959 
966 
O446 $41 GLOBAL STRRGL PROCEDURE 
962 
043 | GaHEBHE HEHEHE HEHEHE HHHEGO GHEE EREEEE | 
944 | i 
$65 | STRRGL STORE Ri INTO CONOBF, } 
964 | QUTPUT POINTER OF CONOBS <OUTPTR} 19 INCREMENTED BY 2 ! 
$47 | ! 
943: | ! 
969 
976 ENTRY 
0440 93F4 971 PUSH = ORAS R4 
442 4104 4 972 Li R4, OUTPTR =! CONGBF POINTER ! 
0444 2E41 973 LOB WR4, RHL ! STORE 1ST BYTE! 
0445 AP40 R74 INC R4 
O4448 DEAS 875 LIE BRS, RiL | STORE GNU BYTE ! 
978 
O440 4501 977 INC GUIFTR, #2 
O450 FPF 4 978 POF R4, 8815 
0452 FE08 879 RET 
986 
781 ENO STRRGL 
982 | PAGE EJECT ! 
583 
964 GLOBAL BRENT PROCEDURE 


SESE AE REEF MEHR ESE AE EAE HEE MES TEE SESE EMER HEHE ESE HE ERE ETE 


494 


$85 
994 | dH HR BUCH HEE HERE HO NEHER EEBBOE OG IHBBHHBEEGEHEE BEE | 
567 } : 
98a | BREAK COMMAND CLEARS PREYIGUS BREAK POINT AND RESET =! 
967 | NEW BREAK FOINT BY REPLACING THE ORGINAL INSTRUCTION ! 
999 ! WITH ILLEGAL INSTRUCTION (OEGO) TO CAUSE A TRAP LATER! 
S91 1 SAVE THE BREAK POINT ADDRESS & ORGINAL INSTRUCTION, ! 
992 1 THE BREAK POINT MUST BE Sct ON EVEN ADDRESS, AND ALSO! 
$93} MUST BE IN EXISTING RAM MEMORY. i 
994 | ! 
995 1 Bee dH HEHEHE RABE SHEE IEE SESE EERE 
996 
997 ENTRY 
998 
597 1 RESTORE PREVIOUS BREAK POINT INSTRUCTION HEFGRE =! 
1000 SETTING NEW BREAK POINT ! 
1001 

9454 6102 1002 Li 21 BRKADR 

G455 6101 1003 Lh Rir INST 

0450 2F2i 1994 Lo @R2, Ri | RESTORE LAST BREAK POINT! 

G45E 408 1005 CLA BRKADR 

462 4008 1004 CLR INST 

0464 4005 1667 Li N1#1 ' CLEAR PREVIOUS BREAK FT! 

046A 0001 
1068 


D460 DEPS 1009 CALR = NXTARG 1 SKIP OVER COMMAND 
S46E 7E06 1610 RET Z 1 NO BREAK ADDRESS : 
1011 
1012 ! GET BREAK ADDRESS & BREAK COUNT, IF BREAK COUNT! 
1913 ! 7S NOT GIVEN, BEFAULT TG i ! 


1014 
0470 BEAR 1015 TALK = GETADN ' GET BREAK ADDR IN R3 
9472 4132 i@la LD R2; RS ! SAVE BREAK ADDR ! 
0474 E605 Loi? Jk Z NTT 1 CR AFTER ADDRNO BREAK 
1018 1 COUNT } 
101% 
474 DEAB 1026 CALF = GETADN ! GET BREAK COUNT 
475 B34 1021 TEST = =—-RB 
047A £402 1022 JR Z1 NOT ! DEFAULT COUNT =i ! 
0470 SFOS i023 NCZi LD Ni RS 
1024 
1025 1 SAVE BREAK ADDRESS AND BREAK INSTRUCTION, REPLACE ! 
1026 ! WITH ILLEGAL INSTRUCTION 10 CAUSE TRAP ! 
1027 
1028 NCT: 
HARD AI26 1029 RES R219 1 MUST BE EVEN ADDRESS 
0482 6FG2 1036 LD BRRADR R2 1 SAVE BREAK PT ADDRESS! 
0486 2121 1031 LI Ris @R2 
0488 OFOl 1032 uD INST, R1 1 SAVE ORGINAL INSTRUCTION! 
0480 é10i 1933 Lo Riv TLEGAL =| REPLACE ILLEGAL INSTRUCT! 
0496 2F21 1034 LD OR2; Rl 
1035 
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0492 2121 1036 Li KL, BR2 1 CHECK If BREAK FT SET ! 
0494 4B0i 43BE 1037 CF Ri, TLEGAL ! AT EXISTING R44 i 
O498 FEDS 1038 RET Z 
1639 
049A 4105 4302 1040 iD Nos #1 
H49E DDOL 
O4A9 4008 430E 1041 CLR BREADR 
O4A4 4008 4300 1042 CLR INST 
0486 SECS G14E 1043 JF ERUR ' TLLEGAL BREAK FT ! 
1044 
O4Al i045 END BRRENT 
1046 | PAGE EJECT ! 
1047 
1948 GLOBAL BGOBRK LABEL 
1049 G0 LABEL 
1050 SFTINT LABEL 
1051 
O4AC 1052 GLOBAL JUMP PROCEDURE 
1053 
1054 UHBR HBB HB BEBE HEHHBH HEHE DEHBBE EI EEEBBBE BBE EB HEEEES j 
1055 ! 
1056 | JUMP COMMAND CHANGES THE USER CURRENT PC AND START i 


y 
1057 ! EXECUTE FROM THAT SPECIFIED FC BY IRET. ¢ IDENTIFIER?! 
! 


1058! FCh» PC ARE ON TOF OF STACK}. ALL USER REGISTERS | 
1057 | ARE RESTORED. } 
1060 | ! 
TOG] HAH HBHBBHBEHHH AHHH HEHEHE HEH HEHB HEHE SOE aaEE | 
1042 
1963 ENTRY 
1064 
1065 ! BET JUMP ADDRESS, AND SET INTO FC ! 
1066 
O4AC DEBS 1047 CALR = -NXTARG 
OA4AE SE06 G14E ©1068 JP Z) EROR 1 JUMP ABDR MISSING 
1069 
O4B2 GECY 1070 CALR = -GETADN 1 GET JUMP ADDR IN R3 
0484 A330 1071 RES R340 | HUST BE EVEN ADDRESS 
O4B6 6F03 43F6 = 1072 LO PEL) RS | CHANGE PC ! 
1073 
1974 
1075 ! CHECK JUMP ADURESS MATCH BREAK POINT ADDRESS ! 
1076 
1077 | TF PC S0E5 NOT MATCH BREAK ADDRESS, RESTORE ALL ! 
1078 ! ALL REGISTERS, AND RETURN TO USER PROGRAM THROUGH! 
1079 | DATA ON STACK ! 
1086 


G4BA 6103 43F4 ©1081 G0: Li R3, PCL 
O4BE 4803 43CE ©1082 cP R31 BRKADR 


1 CHECK IF NECESSARY TO ! 


I 
O42 £604 1083 JR Z GOBRK | REPLACE INSTRUCTION & 
1084 ! CAUSE CTC INTERRUPT ! 

0404 DF4R 1085 CALR RESTOR ! NO NEED) JUST RESTORE REG! 


0406 610F 43F4 ©1086 LD RIS, KLS_ 
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O4CA 7800 


O4CC 2102 0574! 
C400 6103 43CE 


0404 6101 4300 
408 2F31 


O4lA 7001 


O4BC 6F02 


O4E0 DFS? 


O4E2 C700 
(44 SARS 


O4EB COC? 
O4ES SAPS 


O4EE $101 
O4F2 SAPS 


O4F4 oLOF 


1987 
1088 
1089 
1090 
1091 
1092 
1093 
1994 
1095 
1096 
1097 
1098 
1099 
1100 
1161 
1102 
1193 
1104 
1105 
1106 
i107 
1108 
1109 
1110 
ili 
ili? 
1113 
1114 
1115 
11ié 
111? 
1118 
iil? 
1120 
1121 
1122 
1123 
1124 
1125 
1128 
1127 
1128 
1129 
1130 
1151 
Lid? 
1133 
1134 
1135 
1136 
i137 
1138 


IRET 


titi titit tite iti t titi ti tit isi itti tit tt ttt tat ta I 
! 
i IF PC MATCH BREAK ADDR.» RESTORE ORGINAL INSTRUCTION! 
| AT BREAK ADDRESS, AND CAUSE INTERRUPT HAPPEN 

i AFTER EXCUTION OF THAT INSTRUCTION 


JADHHEBBHEIBEEBBHHHBBHE HGH BBE HEHEHE BHD: | 


GORRK: = LI 


LB 
Lo 
Lo 


R2) $BRKINT | BREAK SERVICE ROUTINE ! 
! ADDRESS ! 

R3, BRKADR 

Ri» INST 

G3, RI ! RESTGRE INSTRUCTION! 


JDBHOBOBHHOEBEHBAB IB EHEDHOB HBB BBE BRE HBBROOEEHEHBrEEE | 


SET INTERRUPT SERVICE ROUTINE AT PROGRAM STATUS AREA | 
RESTORE USER REGISTERS» PROGRAM CTC3 TU COUNTER MODE ! 
AND INTERRUPT AFTER EXECUTE THE OFGINIAL INSTRUCTION ! 


POINT, SAVE USER FC 7G RESTORE LATER, 


TURN ON VECTOR INTERRUPT TO CAUSE CTC TO INTERRUPT. 
AND CONTINUE EXECUTING BY IRET, 


JAH HEEEEIEHEHHHEEE EEE IEEE OEE 


| 

| 

! 

I 

1 AT BREAK 
| 

! 

! 

I 


SFTINT: 
it 


Lo 


TALK 


LDB 
GUIB 
LOB 
OUTE 


' TURN OFF INTERRUPT FOR! 
! RESTORE REGISTERS ! 

! FUT INTERRUPT ADDRESS ! 
! IN FROG. STATUS AREA! 
1 USE VECTOR 4 | 


RESTOR T RESTORE REG/PCSFCH ! 


RLir #00 
CICG, RLI i INTERRUPT YECTOR i 
' CICS SEND YECTOR 6: 
RLi, #CNTHOD 
CICS: RLL i COUNTER MODE ! 


: SET CTC TIME GONSTART TG 4 FOR 4 STACK OPERATION! 


Lo 
OUTB 


iil 


Ri + TIMCNT 
CTC3, RLI 1 TIME CONSTANT ! 


RU, RIS_ 
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O4FA SIF1 1139 R1y R13 (#2) ! 1ST STACK ! 
O4FE FOL 1140 USFCK, Ri 1 CHANGE FC --} EI VI ! 
0502 0501 1i4l Rly €VINT 
0506 S3F1 1142 R15 (#2) 7 RL ! 2ND STACK ! 
050A 6101 1143 Rir RL 
QS0E 7800 1144 1 SRD & 4TH STACK ! 
1145 
0510 1146 END JUMP 
1147 | PAGE EJECT ! 
1146 
0510 1149 GLOBAL NEXT PROCEDURE 


HRB B BEBE HHH BEEBE HHH HEHEHE HEHEHE HEHE EE | 


| 
) NEXT STEP THROUGH USER PROGRAM INSTRUCTIONS BY 
INSTRUCTIONS 

1 IF THE CURRENT PC MATCH THE BREAK POINT ADDRESS, 
! THE NEXT COMMANI WILL CLEAR THE BREAK POINT. 

1 

I 


JABBEHBB HEB HBB HEB EBEDEHEHHB EHUB HED HEHEHE HBB RHEE 


ENTRY 
! GET NEXT COUNT, DEFAULT TG ONE, PRINT HEADER ! 


0519 DEES 3 2 NXTARE 
0512 £603 1) Bt | NO COUNT ! 


0514 DEFA 5 GETADN ! GET COUNT IN R3 | 
0516 Bb34 
0518 E£01 
O14 BhS1 1147 Dit LBK R 1 DEFAULT TO i! 
OS1C 4FO3 1170 NOK: =—oLD 3 
0529 DELB 1171 CALR = -RHEDL 
0522 BDFD 1172 TALR = RHED2 
1172 
1174 ! TF PO MATCH BREAK ADDRESS: RESTORE ORGINAL : 
i175 ! INSTRUCTION AND CLEAR THE BREAK POINT ! 
il7e 
L177 NXTL: 
0524 2102 ¢ 1178 LB R2, $TRCINT { INT, SERVICE ROUTINE! 
1179 : FOR NEXT ! 
0528 6103 1189 Li Rd, BRKADR 
O520 4803 » 1181 CP RS, PCL 
0530 EEb4 1182 JR NZ» SFTINT 1 THE NEXT INSTRUCTION NOT! 
1183 | AT BREAK POINT ! 
0532 4103 4 1134 Lil RS, BRKADR 
0536 oil 1185 LD RL INST ! PUT BACK ORGINIAL INST. | 
O558 3F31 i164 LE ORI RI 
N53 EBCE 1187 Jk SFTINT 
i188 
QS3E 118? ENO NEXT 
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OS3E 


OS3E OF OF 
0542 6F00 
0546 DFID 


0548 DFAS 
054A 6102 
OS4E 6101 
0502 2F21 


0554 6700 
0558 EE02 
055A 6300 


QS5E DE26 
9560 DESC 
0562 46800 
0566 EEDE 


0568 4005 
O56 0001 
096E 7005 
0570 SE08 


6574 


0574 


43F4 
4306 


4302 


432 


OOEC? 


1199 | PAGE EJECT ! 

1191 

1192 GLOBAL TRCINT PROCEDURE 

1193 

1194 ! JEG BHEHHBHEHHBB EB HE BEBE HEHE HEE EEE ! 

1195 | 

1196 | CTC INTERRUPT FOR NEXT | 

1197 | INTERRUPT SERVICE ROUTINE FOR NEXT INSTRUCTION 
| 
i 


1198 ! ! 
1.199 _JBHHHHBEEOHBBRHBBBHEHAHEHEEEBH BH HHEHEHEBHEH EBB BEEHHGE 
1200 

1201 ENTRY 

1202 LD R15.» RIS 

1203 LD RO_» RO 1 SAVE RORIS FIRST ! 
1204 CALR = SAVREG ! SAVE STACK INFORMAT. ! 
1205 ! AND REGISTER 1-14 ! 
1206 

1207 CALR = -RESCTC ! RESET CTC ! 

1208 LD R2,BRKADR 

1209 LD RL TLEGAL ! PUT BACK ILLEGAL INST. ! 
1210 LD @R2R1 ! IN CASE GOT CLEAR ! 
1211 

1212 BIT USFCHs #BVINT =! FIX VI IN FCH ! 

1213 JR NZ» NFIX 

1214 RES SAVFCNy #BVINT 

1215 NFIX: 

1216 CALR — PUTRGL 

1217 CALR = PUTRG2 ! PUT QUT REG CONTENT! 
1216 DEC N. 

1219 JR NZ NXTL ' CONTINUE ON ! 

1220 

1221 LD Noy #1 ! SET COUNT TO 1 AGAIN! 
1222 EI VI 1 ALLOW INTERRUPT! 
1223 JP DEBUG 

1224 


1225 END TROINT 

1226 ! PAGE EJECT ! 

1227 

1228 

1229 GLOBAL BRKINT PROCEDURE 

1230 
WASMEEiiiiiiititiiiiiiiiiiiiitiiiitiiititiiitirit titi t tite al 
1232 ! | 
1233 ! CTC INTERRUPT FOR BREAK | 
1234 ! INTERRUPT SERVICE ROUTINE FOR EXCUTING ORGINAL ! 
1235 ! INSTRUCTION AT BREAK POINT, PUT BACK ILLEGAL | 
1236 ! INSTRUCTION AND RESTORE USER FCH ! 
1237 ! ! 
WAPMRISEIECITECTititiiiteiitiitiittitiitittii tit itt it ttt Tae 
1239 

1240 ENTRY 
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0574 93F2 1241 @R15, R2 
0576 93FL 1242 @RIS, Ri 
1243 
0578 DFCO 1244 RESCTC 
1245 
057A 6102 1246 R2y BRKADR 
Q57E 6101 1247 Ri, ILEGAL 
0582 2F21 1248 @R2, Ri ! PUT BACK ILLEGAL INST! 
1249 
0584 470C 1250 USFCH, #BVINT 
0588 EE0S 1251 NZ» NOFIX ! DEBUG SET VI ALREADY ! 
058A 3LF2 1252 R2r RIS(#4) ! STACK ORDER:R2 R11! 
1253 1 IDENT »FCWePC ! 
O58E A320 1254 R21 &BVINT ! RESET VI IN FCH ! 
0590 33F2 1255 R15 (#6) R2 
1256 
0594 97F1 1257 NOFIX: POP Rly @RIS 
0594 97F2 1258 POP R2, BRIS 
0598 7B00 1259 IRET 
1240 
059A 1261 END BRKINT 
1262 ! PAGE EJECT ! 
1263 
059A 1264 GLOBAL NMINT PROCEDURE 
1265 
WIM Tiiitiiiiiiiiiiitiiitiiiiiitiitiiitiitii tt tthe 
1267 ! ! 
1268 ! NMINT SERVICE ROUTINE RESPONSE TO THE NMI SWITCH. ! 
1269 |! IF SYSTEM IS IN TRANSPARENT MODE, IT WILL SEND AN ! 
1270 ! ESCAPE KEY TO MCZ» AND RESET THE STACK. ! 
1271 ! IF SYSTEM IS RUNNING USER PROGRAM, IT SAVE ALL wee ! 
1272 ! REGISTERS» PC,FCH, 
1273 ! | 
WIM iiiitiiiiiiiiiiitiitiiiiiiiiiiiiiiiitiiiiiiiii tise 
1275 
1276 ENTRY 
059A 4700 1277 BIT CFLAGS-#TRNMDE | CHECK IF IN TRANSPARENT! 
OS9E EE06 1278 JR NZ, QTRAN ! YES, SEND ESCAPE ! 
1279 
OSA 4FOF 1280 LD RIS_ R15 ! SAVE USER REGISTER...! 
O5A4 6F00 1281 LD RO_»RO 
O5A8 BFCE 1282 CALR  SAVREG 
O5SAA E808 1283 JR PNHI 
1284 
OSAC 6300 1285 QTRAN: RES CFLAGS $TRNMDE |! RESET TRANSPARENT BIT ! 
OSBO 210F 12864 LD R15, STACK 
05B4 6FOF 1287 LD Ri5_ R15 1 RESET STACK POINTER ! 
05B8 C81B 1288 LDB RLOs #ESCHAR ! SEND ESC KEY TO MEX ! 
OSBA DF17 1289 CALR HCZSND 
1290 
058C 7005 1291 PNHI: VI 
OSBE DFLO 1292 CRLF 
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05C0 2102 OEAE 
0004 BES? 
05Cé SE08 O0EC’ 


050A 


OoCA 


OSCA OFOF 43F4 
OSCE 6F0O 4306 
O5D2 DFES 


05D4 6B01 43F6 


0508 6B00 4302 
OSDC SEOE 04CC 
O5E0 4005 4302 
OSE4 0001 


05E6 7005 
O5E8 2102 OEA4 


QSEC DED 
OSEE 6105 43F6 
OSF2 DEét 
OOF4 DESO 
OSF6 SEOB O0EC’ 


OOFA 


OSFA 


OSFA C9ED 
OSFC 3A96 FF? 


1293 
1294 
1295 
1296 


LD R2r #NHINSG =! PRINT NHI HESSAGE ! 
CALR = PUTHSG 
JP DEBUG 


1297 END NMINT 
1298 ! PAGE EJECT ! 


1299 


1300 GLOBAL BREAK PROCEDURE 


1301 


1302. 14H0HHHHH}0HHBBHHEHHBBHHBBHEBHE BBE BEBE BBE BHEBE I 


1303 


1304 ! BREAK CAUSE BY ILLEGAL INSTRUCTION, SAVE USER REGISTER! 
1305 ! PC & FCW.CHECK BREAK COUNT» CONTINUE IF COUNT NOT 1 ! 


1306 | 
1307 Pettitt iit itiitititiiiiiiitiiitiititittiit ett Tt ttt | 
1308 

1309 ENTRY 

1310 LD RIS) RIS 

1311 LD RO_ RO 

1312 CALR SAUREG | SAVR ROvTEDNT/FCH PC! 
1313 1 AND REGISTER ! 

1314 DEC PC» #2 | BACK UP TO BREAK ADDR ! 
1315 

1316 

1317 DEC Ny # | DEC BREAK COUNT ! 
1318 JP NZ» GOBRK | CONTINUE IF NOT 1 ! 
1319 LDN Ht | SET BREAK COUNT=1 ! 
1320 

1321 fl WI | ALLOW KB INTERRUPT ! 
1322 LD ——sR2p #BRKNSE 

1323 

1324 CALR —PUTHSG 

1325 LD RS» PCL | PUT OUT MESSAGE WITH! 
1326 CALR PUT? | BREAK ADDRESS ! 
1327 CALR —PUTPTR 

1328 JP DEBUG 

1329 


1330 END BREAK 
1331 ! PAGE EJECT ! 


1332 

1333 GLOBAL RESCTC PROCEDURE 

1334 

1.335 | 068HGHHHGHEEDEBBBBHEB BEEBE BHHEG HH DOBBS BBBHEBE [ 
1336 ! ! 
1337 | RESET CTC BY SIMULATE 280 RETI INSTRUCTION AND ! 
1338! SEND DATA 03 TO CTC3 ! 
1339 ! ! 
Re iiiiiiitiitititireriietritititisst attr ral 
1341 ENTRY 

1342 LDB RLiy ZED ! SIMULATE 280 RETI ! 

1343 OUTB=—-RETI, RLI 


501 


502 


0600 C94D 
0602 3A% 
0605 C903 
0608 3A% 
0600 9E08 


O60E 


O60E OF OF 
0612 31FO 
0616 6F00 
061A SIFO 
OS1E 4F00 


0622 210F 
0626 1CF9 
062A 6L0F 
062E 9E08 


0630 


0630 


0630 6FOF 
0634 610F 
0458 6101 
0630 33Ft 
0640 6101 
0644 33FL 


0648 210F 
O64C CFL 
0650 G10F 
0654 9E08 


FF29 
FFI7 


1344 
1345 
1346 
1347 
1348 
1349 


LDB 
GUTB 
LDB 
OUTB 
RET 


1350 END RESCTC 


1351 
1352 


RLiy #24) 
RETIy RLi 
RLiy #23 
CTC3, RLI ! RESET CTC3 ! 


1353 GLOBAL SAVREG PROCEDURE 


1354 


ERNIE EEtitiiiiitititiiitiiiiiiiitiiiitiiiiiiteri ttt tT Tt ae 


1356 
1357 


1359 
1360 
1361 
1362 ENTRY 
1363 
1364 
1345 
1366 
1367 
1348 
1349 
1370 
1371 
1372 
1373 


LD 
LD 
LD 
LD 
LD 


LD 
LDH 
LD 
RET 


1374 END SAVREG 


1375 
1376 


1 SAVREG SAVE USER FCW AND PC FROM STACK. ALSO SAVE | 

1358 ! ALL USER REGISTER CONTENTS REG 1-14 | 
| | 
! 


JHHBBBBBHBHB HEHEHE BEB HEHEHE HEHEHE HEHE 


RETSP, R15 =! SAVE RETURN ADDRESS ! 

ROr RIS(#4) =! EXTRA RETURN ADDRy IDENT. ! 
SAVFCH, RO =! BEFORE USER FCW ! 

ROr RIS(#6) =| USER PC ! 

PC_» RO 


RiSy aR1 
@R15, Riv #14 | SAVE REG 1-14 ! 
RiSy RETSP 


1377 GLOBAL RESTOR PROCEDURE 


1378 


1379 | HBB OBO HHOHEHBEHGHEBE A HBHBEBHHEG BBE HBEBEBEBBBHEE | 


1380 ! 


1381 ! RESTOR RESTORE ALL USER REGISTER, PC, & FCH 


1382 ! 


ARMM SEcEiitststtiittitiitiiititiitiitiittst tats t tt tae 


1384 ENTRY 
1385 
1386 
1387 
1388 
1389 
1390 
1391 
1392 
1393 
1394 
13995 


LD 
LD 
LD 
LD 
LD 
LD 


LB 
LOM 
LD 
RET 


RETSF, RIS =| SAVE RETURN ADDRESS ! 
R15, R15 

Rly SAVFCH 

R15 (#2), Ri 

Rir PCL 

R15(#4)> Ri 


Ri» #RO_ 
RO, ORIG, #15 | RESTORE REG 0-14 ! 
Rid, RETSP 


0656 CBC 
0658 DF72 
065A DF4E 


O60 8028 
OSE 8038 
0660 DF8B 
0662 7606 


0664 OA0S 
0668 EE02 
066A 8081 
0660 9E08 


O46E DFBB 
0470 €75F 
0672 BEBB 
0674 BE38 
0676 BEAG 
0678 BE28 
047A DF48 


0470 E604 


3151 


1396 

1397 END RESTOR 

1398 |! PAGE EJECT ! 

1399 

1400 ! UTILITY SUBROUTINES 
1401 

1402 GLOBAL GETNUM PROCEDURE 

1403 


14040 | J8HBHAHEH HEHEHE HEHEHE ESHER HBHBBEBBEE [ 


1405 
1406 
1407 
1408 
1409 
1410 
1411 


FILL WITH LEADING HEX ZERO 
QUIPUT: R2, R3 = EIGHT 4-BIT 


1413 
1414 
1415 
1416 
1417 
1418 
aly 
1420 
1421 ENTRY 

1422 RLO, #7? 

1423 TYWR 

1424 GET ! 
1425 

1426 R2 ! 
1427 R3 

1428 SKIPSP ! 
1429 Z ! 
1430 

1431 RLO, #0! ! 
1432 NZ, XHORE =! 
1433 C 

1434 ! 
1435 

1436 

1437 XMORE: CONVERT 
1438 

1439 Cr ERRE 
1440 RLO» RL3 
1441 RLO» RH3 
1442 RLO» RL2 
1443 RLO» RH2 
1444 

1445 

1446 

1447 


| 
! 
| 
! 
| 
if I 
1412 ! RET C FOR RECEIVING 'Q7 | 
i ! 
| 
! | 
! 


GETNUM GET i LINE OF INPUT AND PACK 8 ASCII CHAR INTO 
DOUBLE WORD HEX VALUE. IF RECEIVE LESS THAN 8 CHAR 


HEX YALUE 


RET NC»Z IF CARRIAGE RETURN ONLY 
RET NC/NZ» IF CHARACTERS FOLLOWED BY SPACE 
JUMP TO ERROR IF RECEIVE NON-ASCII CHAR 


44% RO. Rie R2r RF ARE LOST set 


JHHHBBHBHB BBB DEH HBE HBB BBBBH HB EB UHBBEBE HEHEHE HEE 


GET LINE IN CONIBF ! 
R2sR3=0 ! 


SKIP LEADING BLANK ! 
RET NCrZ FOR RECEIVE CR! 


CHECK IF QUIT ! 
NO ! 


RETURN C FOR ’Q? 


! CONVERT 8 BIT ASCII CHAR! 


TO 4 BIT HEX VALUE ! 


! BAD CHAR ! 
! SHIFT HEX VALUE INTO =! 


RIGHT MOST LONG WORD IN! 
R2z R3 ! 


! NEXT CHARACTER/RET NC & ! 


Z FOR CR ! 
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1448 1 NC IS RESULT FROM GCHAR ! 
1449 | CP INSTRUCTION | 

067E OAOB 2020 1450 CPB RLOy #?’ | IF HIT? "> END OF INPUT! 

0682 EEFS 1451 JR = NZr XHORE 
1492 

0684 8083 1453 RESFLG C 
1454 

0686 8043 1455 RNZ! —RESFLG 7 | RETURN NZ»NC FOR INPUT ! 

0688 9E08 1456 RET | FOLLOW BY SPACE OR CR ! 
1457 

068A 1458 END GETNUM 
1459 ! PAGE EJECT ! 
1460 

068A 1461 GLOBAL TTY PROCEDURE 
1482 
IRM iiitiiiiiitiiiiiitiiitiitiitiiii iii t esti tiie tit tt i 
1464 ! 
1485 | RECEIVE AND ECHO INPUT LINE, STORE LINE IN BUFFER | 
1466 |! ADDRESS BY R2y SIZE OF BUFFER IS SPECIFIED BY RI, —! 
1467 | TERMINATE LINE HHEN RECEIVE CARRIAGE RETURN 
1468 ! THIS ROUITINE ALSO HANDLE DELETE CHARACTER AND 
1469 | LINE DELETE CHARACTER. ALL CHARACTER ARE STORED IN! 
1470 | UPPER CASE 
1471! 
1472 | INPUT: RL = SIZE OF BUFFER IN BYTE 
1473 ! R2 = BUFFER ADDRESS 
1474 ! 
1475 | OUTPUT: R1 = # OF CHARACTERS RECEIVED 
1476 |! INPUT LINE STORED IN BUFFER ADDRESSED BY R2 ! 
1477 | 
1478 |! RETURN Z IF BUFFER SIZE EXCEED LIMIT 
1479 | RETURN NZ FOR RECEIVING INPUT LINE WITH CR! 
1480 ! ! 
1481 ! #9 ROr Rip R2 ARE LOST x¥x | 
1482 ! 
UNAM iiteittitiiiiitiitiiitiiestittitititititt ttt ttt ! 
1484 
1485. ENTRY 
1486 

048A F02 1487 LD CBUFADR, R2 ! SAVE BUFFER ADDR & SIZE! 

O6BE 6FO1 1488 LD = CBUFSIZ, Ri 
1489 

0692 6102 1490 BEGN: LD  R2y CBUFADR ! BUF ADDRESS! 

069% abi8 1491 CLR Rt | COUNT ! 
1492 

0698 DFD2 1493 RDLOP: CALR — TTYRD | GET CHAR & ECHO ! 
1494 
1495 | CONVERT ALL LOWER CASE ALPHA TO UPPER CASE ! 
1496 

069A OA0B 1497 CPB RLOs #261 

O69E £704 1498 JR Cy NOCHK «=! NOT LOWER CASE ! 

06A0 OA0B 1499 CPB RLOy #278 
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O6A4 EFOL 
O6A6 A285 


06A8 2E28 
OSAA 4A08 
OSAE EEOD 


04B0 AB20 
04B2 ABLO 
04B4 4B02 
06B8 E705 
O6BA C820 
OBC DFA4 
OSBE C808 
06CO DFAS 
0602 EBEA 


0604 C83C 
0606 DFAY 
0608 EBE4 


O6CA 4A08 
O6CE £409 
0600 A920 
0602 AVL0 
0604 OAQ8 
O6D8 E60A 
ODA 4B01 
ADE EEDC 
06E0 9E06 


06E2 CBSE 
O4E4 DFB8 
O6E6 DFAS 
O6E8 C820 
OSEA DFBB 
OSEC EBD2 


OSEE C80A 
OOFO DFBE 
ObF2 8143 
O4F4 9£08 


O6F6 


1500 

1501 

1502 

1503 NOCHK: 
1504 

1505 

1506 

1507 

1508 

1509 

1510 

1511 

1512 

1513 

1514 

1515 

1516 

1517 

1518 STARTS: 
1519 

1520 

1521 

1522 CKHRE: 
1523 

1524 

1525 

1526 

1527 

1528 

1529 

1530 

1531 

1532 DELIN: 
1533 

1334 

1555 

1536 

1537 

1538 

1539 FINLIN: 
1540 

1341 

1542 

1543 

1544 

1545 

1546 END TTY 


LDB 
CALR 
JR 


CPB 


LDB 
CALR 


NC, NOCHK 
RLO, #LOWCSE ! CONVERT TO UPPER CASE ! 


@R2r RLO 
RLO, CHRDEL ! CHECK FOR DELETE CHAR! 
NZ» CKARE 


R2) #1 ! RECEIVE DEL» BACK UP 1 ! 
Ri 

R2) CBUFADR ! CK TOO MUCH BACK SPACE ! 
C, STARTS =! BACKUP TOO HUCH ! 

RLO, #? ? 

TYHR 

RLO, #BACKSP ! ERASE LAST CHAR ! 

TYHR 

RDLOP 


RLO, #7¢? 
TYHR 1 PREVENT BACKUP TO WRAP! 
BEGN 1 AROUND ! 


RLO, LINDEL ! CK FOR LINE DELETE ! 

Z, DELIN ! YES, START AGAIN ! 

R2y #1 ! ADVANCE BUF ADDR & COUNT! 
Ri 

RLO» #ASCICR ! CK FOR CR! 

Z, FINLIN =! YES, TERMINATE WITH LF! 
Ri» CBUFSIZ | CHECK IF EXCEED BUF SIZE! 
NZ, RDLOP =! NO» GET NEXT ! 

Z ! ERROR» TOO MANY CHAR ! 


RLO, $45E =! CHAR FOR DELETE LINE ! 
TYHR 

CRLF ! FORGET THIS LINE» START ! 
RLO, #! ? 

TYWR 

BEGN 1 INPUT ON NEXT LINE ! 


RLO» @ASCILF 
TYHR ! QUPUT LF ! 


RESFLG Z ! RETURN NZ FOR OK ! 
RET 


505 


1347 
1548 
1549 GLOBAL TTYRD PROCEDURE 


WMI ititiiiiiiiiiiiiiiiiiitiiiiiitiiiiiiiiiiittiti itt t ae 

1552 ! ! 

1553 ! TTYRD GET SINGLE CHARACTER FROM INTERRUPT INPUT BUFFER! 

1554 ! AND ALSO ECHO BACK TO TTY. IF BUFFER EMPTY» WAIT UNTIL! 

1555 ! IT RECEIVE CHARACTER ! 

1554 ! ! 

1557 ! OUTPUT: RLO = CHAR & RETURN Z IF CHAR IS CR ! 

1558 ! ! 

WWMM TIiTiiiiiiiitiiiiittiiiiiiiiiiitiiiiiiitiittiitt iit tae 
1560 
1541 ENTRY 

O6F6 DFCD 1542 CALR ~=TYIN 

O4F8 EB3E 1543 JR TYWR 

OSFA 1564 END TTYRD 
1565 ! PAGE EJECT ! 
1564 

O6FA 1547 GLOBAL CONVERT PROCEDURE 
1548 
WAM tiitiiiiiiiiiiitittiitiiiiititiitiiitttii te 
1570 ! 
1571 ! CONVERT CHANGE 8 BIT ASCII CHAR. TO CORRESPONDING ! 
1572 ! 4 BIT HEX VALUE. IF CHARACTER OTHER THAN 0-9) A-Fy ! 
1573 | JUMP DIRECT TO ERROR » FIX STACK» PRINT ? & RE-ENTER ! 
1574 ! DEBUG. (1.6, 39--)9 41--)A) ! 
1575 ! ! 
1576 ! INPUT: RLO = 8 BIT ASCII CHARACTER ! 
1577 ! ! 
1578 ! ! 
1579 ! ! 
1580 ! RETURN C IF CHAR IS NON-ASCIT ! 
1581 ! RETURN NC IF OK 1 
1582 ! ! 
WURMME ti tiiiiiiisiitiiiitiiiiiiiiiiitiiiitiiitiiiii iti t tt ae 
1504 
1585 ENTRY 

OSFA OAD 3030 1584 RLOr#?0! ! NO CHAR ¢ 30H 

OSFE 9E07 1587 C ! BAD CHAR 

0700 OA08 3A3A 1588 RLO, #99741 0! CK IF DIGIT 

0704 £708 1589 C+ NOSUB 

0706 OAOS 4141 1590 RLO» #7A? ! DON’T ALLOW 40H 

070A 9E07 1591 C 

070C OA08 4747 1592 RLOr #°F’+1 =! NO ALPHA ) F 

0710 EFO6 1593 NCy RETC 

0712 0208 0707 1594 SUBB se RLOy -€7 ! FIX UP IF ALPHA 

0716 0608 OFOF 1595 NOSUB: ANDB RLOr #40F  ! ONLY NEED 4 BITS 

O71A 8D83 1594 RESFLG C 

0710 9E08 1597 RET 
1598 


OUTPUT: RLO = 4 BIT HEX VALUE NITH LEADING ZERO 


506 


O71E 8081 1599 RETC: SETFLG C 

0720 9£08 1600 RET ! RET C FOR BAD CHAR 
1601 

0722 1602 END CONVERT 
1603 
1604 

0722 1605 GLOBAL GETADN PROCEDURE 
1606 
1607 
1608 
1609 
1610 
1611 
1612 
1613 
1614 
1615 
1616 


1) HEHEHE 1H 1H ae 
! 
! 
! 
! 
! 
1 
! 
| 
| 
1617 ! OUTPUT: R3 = HEX VALUE NUMBER 
! 
! 
| 
! 
! 
! 
! 
! 
! 
| 


GETADN CONVERT NEXT ARGUMENT IN CONIBF BUFFER & 
CONVERT TO A HEX ADDRESS, ONLY TAKE LAST 4 CHARACTERS 
1ST CHARACTER OF THE ARGUMENT IS ALREADY IN RLO 


INPUT! RLO - 1ST CHAR OF THE ARGUMENT 
HL - POINTER TO 2ND CHAR OF THE ARGUMENT 


1618 
1619 
1620 
1621 
1622 
1623 
1624 
1625 
1626 
1427 
1628 
1629 ENTRY 

0722 8038 1630 R3 ! CLEAR ADDRESS VALUE ! 

0724 OAOB ODOD 1631 RLO, #ASCICR ! CHECK CHARACTER FOR CR ! 

0728 EE02 1632 NZ» NCR ! BRANCH IF NOT CR ! 

0724 8DB1 1633 C ! RETURN Z? C FOR RECEIVE! 

0720 9E08 1634 1 CR ONLY ! 
1635 
1434 NCR: 

O72E DO1B 1637 CONVERT ! RETURN 4 BIT HEX VALUE ! 

0730 5E07 1638 ERRE: Cr EROR ! BAD CHAR ! 

0734 BEBB 1639 RLO? RL3 ! SHIFT VALUE IN RIGHT 

0734 BE38 1440 RLOy RH3 ! MOST POSITION 
1641 

0738 DFC7 1642 GCHAR | NEXT CHAR IN CONIBF =! 
1643 ! (CP RLOs $ASCICR) WILL ! 
1644 ! RETURN NC ! 
1645 

073A 9E04 1646 ' RETURN Zr NC FOR RECEIVE! 
1647 ! CR AFTER ARGUMENT ! 
1648 

073C 0A08 1649 RLO, #’ ’ =! CHECK IF SPACE ! 

0740 EEFS 1450 NZ: NCR ' WO» CONVERT NEXT CHAR ! 


RET ZC IF ONLY CARRIAGE RETURN 

RET ZsNC IF ARGUMENT FOLLOWED BY CR 

RET NZ+NC IF ARGUMENT FOLLOWED BY SPACE 

JR TO ERROR» IF RECEIVE CHARACTER OTHER THAN 
0-9/A-F/ER 


x RO IS LOST Ht 


| 
! 
| 
! 
! 
! 
! 
! 
| 
! 
! 
| 
! 
! 
| 
| 
! 
! 
! 
| 


JEHA HEHEHE HEH HEHEHE HEEB HEEB HEHEHGHE 


507 


508 


0742 DFFF 


0744 8083 
0746 9E0B 


0748 


0748 


0748 DFCF 
074A 9E06 
074C OA08 2020 
0750. EEFB 


0752 


0752 BFD4 
0754 9606 
0756 OA0B 2020 
075A E6FB 
0750 9E08 


1651 CALR — SKIPSP | SKIP OVER BLANK ! 

1652 1 AND GET NEXT NON-BLANK ! 

1653 1 CHAR IN RLO ! 

1654 RESFLE C 

14655 RET | RETURN NZPNC FOR SPACE ! 

1656 | AFTER ARGUMENT ! 

1657 

1658 END GETADN 

1659 

1460 

1661 GLOBAL NXTARG PROCEDURE 

1662 

UNM itiittiitiiiititiiitiititiititiiittiistitit titi ttt) i 

1664 ! ; 

1665 | NXTARG SKIP OVER CURRENT ARGUMEMNT AND THEN BLANK | 

1666 ! TO FIRST NON-BLANK CHARACTER 

1667 ! 
i 
1 
| 
t 


1668 ! QUTPUT: RLO = NON-BLANK CHARACTER OR CR 
1669 ! RETURN Z IF CHARACTER IS CARRIAGE RETURN 
1670 ! 


WWMM isiitiicititiitittiitititiititiiitierttri ttt tte t t 4 
1672 


1673 ENTRY 

1674 CALR GCHAR 

1675 RET Z ! RET FOR HIT CR ! 
1676 CPB RL, #? ’ | SKIP CURRENT ARGUMENT ! 
1677 JR NZr NXTARG 

1678 


1677 | FALL THROUGH TO ROUTINE SKIPSP 
1480 
1681 END NXTARG 


1682 

1683 

1684 GLOBAL SKIPSP PROCEDURE 

1685 

1686 | JHHHHBHBHEEHEEIHEBHEEBOHEHEIBHEBEEB HHH HHEHHHHHBBHBHBE | 
1687 ! ! 
1488 ! SKIPSP OVER BLANK TO FIRST NON-BLANK CHARACTER | 
1689 ! ! 
1690 | QUTPUT: RLO = CHARACTER ! 
1691 ! RETRUN Z IF CHARACTER 15 CARRIAGE RETURN ! 
1692 ! ! 
1693 | RHHERBRHBBIEBEB EEE HHBHHHBEHE RHEE SH ABEHEHEBEHHHBHE | 
1694 

1695 ENTRY 

16% 

1697 CALR GCHAR 

1498 RET 2 1 RECEIVE CR ! 

1699 CPB RLO, # ? 

1700 AR Z) SKIPSP 

1701 RET 


1702 


O75E 6100 
0762 4800 
0766 EOFB 


0768 93F2 
976A DFC7 
0760 6F00 


0770 2028 
0772 97F2 
0774 9E08 


0776 


0776 


0776 6702 
077A EEFD 


0770 3A04 
0780 Adb02 
0782 E6F9 
0784 3AR4 
0788 0A08 


4306 
4304 


4304 


FFAF 


FFB 
DOD 


1703 END SKIPS 


1704 
1705 


1706 GLOBAL TYIN PROCEDURE 


1707 
1708 
1709 
1710 
1711 
1712 
1713 
1714 
1715 
1716 
1717 


| RHBOBEHRHBHHHBGB OOH HHHHEHHBHBOGHHBBBBEBHBBB BBHBHBEEHE [ 
GET CHAR FROM INTERRUPT INPUT RINGBFs NO ECHO ON TTY 
QUTPUT: RLO = CHAR 
4 RO TS LOST ste 
[3 0 0 0 0 0 i i i : 


1718 ENTRY 


1719 
1720 
1721 
1722 
1723 
1724 
1725 
1726 
1727 
1728 
1729 
1730 


RO» TTYGET =! IF TTYGET=TTYPUT:THEN ! 
RO» TTYPUT ! BUFFER EMPTY ! 
Zr TYIN L WAIT ciuisieseccscoes 


BRIS, R2 

GBFADR ! GENERATE RINGBF ADDR ! 

TTYGET, RO! UPDATE RINGBF GET CHAR ! 
! POINTER ! 

RLO, @R2 ! GET THE CHARACTER ! 

R2y BRIS 


1731 END TYIN 


1732 
1733 


1734 GLOBAL TYWR PROCEDURE 
1735 


1736 
1737 
1738 
1739 
1740 
1741 
1742 
1743 
1744 
1745 


J 3 1 0 iE 


| 
j 
! TYWR CHECK IF XOFF CHARACTER IS RECEIVED BEFORE ECHO 
| CHARACTER IN RLO TO THE TERMINAL 

| 

! QUTPUT: RLO = SAME CHARACTER 

| RETURN Z IF OUTPUT CHAR IS CR 

I ! 
MTiiiiiiiiiiiiiiiitittiiitiiiiiitiitiitiitt titty 


1748 ENTRY 


1747 
1748 
1749 
1750 
1751 
1752 
1753 
1754 


BIT CFLAGS» €0UTHLD ! DON’T OUTPUT IF RECEIVE! 
JR NZr TYHR ! XOFF CHAR, WAIT...... ! 


INB = RHO» SIOCB 
BITB RHO» #TXRDY 
JR Zr TYWR 

OUTB = SIODBy RLO 
CPB «RLO, #ASCICR 


509 


078C 9E0B 1755 RET 

078E 1756 END TYHR 
1757 
1758 

078E 1759 GLOBAL MCZSND PROCEDURE 
1740 
WSL iiiiiiiiiiiiiiiiiiiiiiiiitiiiiiitiiiiittiiiiii ttt ae 
17462 
1743 
1764 


! 
! HCZSND OUPUT B-BIT DATA IN RLO TO SIO CHANNEL A 
! 

1745 ! 
! 
! 
! 


DATA PORT. (SEND CHARACTER IN RLO TO MCZ) 


1766 
1767 
1768 i 
1769 1) JHB HEEHEHBEEHEHE HB REB HEHE EERE HEHEHE 
1770 ENTRY 
O78E 3A04 FFID = 1771 INB RHO, SIOCA 
0792 Ab02 1772 BITB =—-RHO,#TXRDY =! CHECK IF TRANSMIT READY! 
0794 EOF 1773 JR Zr HCZSND 
0796 3AB6 FFI9 = 1774 QUTB = SIODAy RLO =! QUTPUT DATA ! 
079A OA0B ODOD 1775 CPB RLO» #ASCICR 
O79E 9€08 1776 RET 
07A0 1777 END HCZSND 
1778 
1779 
97A0 1780 GLOBAL CRLF PROCEDURE 
1781 
1782 | 
1783 ! 
1784 ! 
1785 ! 
! 
| 
! 


INPUT: RLO = 8 BIT DATA 
RETURN Z IF CHARACTER 15 CARRIAGE RETURN 


! 
! 
| 
| 
| 
! 
{ 
! 


JXHHAHHHHBBHHHHIHHEHOHE BEEBE OHHH BBB BE HEHBHBBE | 


CRLF OUTPUT CARRIAGE RETURN AND LINE FEED 


1786 
1787 
1788 
1789 
1790 ENTRY 

07A0 C8OD 1791 RLO,FASCICR 

O7A2 0017 1792 TYHR 

O7A4 TBOA 1793 RLO» #ASCILF 

07A6 DOL? 1794 TYWR 

O7A8 SEOB 0962’ 1795 NULL ! PRINT NULL CHAR IF ANY ! 

O7AC 1796 END CRLF 
1797 
1798 

07aC 1799 GLOBAL GCHAR PROCEDURE 
1800 


! 
| 
! 
wee RO TS DESTROYED ieee | 
} 
! 


JEBHB HB BHHHOHBBBBBBIBBHHHB HEEB HBBEHAB BBE HEIGBEEEABEEE 


510 


IMME TTT tii itiitisiisiiiisiititisititititireistis iii i tts al 
1802 ! ! 
1803 ! FETCH A CHARACTER FROM CONIRF THEN INCREAMENT BUFFER ! 
1804 ! POINTER (INPTR) BY 1 ! 
i805 ! | 
1804 ! QUTPUT: RLO = CHARACTER I 
1807 ! ! 
1808 ! RETURN Z IF RECEIVE CR ! 
1809 ! ! 
MMT fiiiitititiiiiiiiiitiiiiieiiitititiiciiiie tit itt at 
1811 
1812 ENTRY 
O7AC 93F2 1813 ORIG, R2 
O7AE 6102 1814 R21 INPTR 
0782 2028 1815 RLOr @R2 ! FETCH CHAR ! 
0784 6900 1814 INFTR, #1 ! ADVANCE CONIBF POINTER! 
0758 OA0B 1817 RLO, #ASCICR 
O7bC 97F2 1818 R2y @R1S 
O7BE 9E08 1819 
07C0 1820 END GCHAR 
1821 
1822 
0700 1823 GLOBAL GET PROCEDURE 
1824 
1825 
1824 
1827 
1828 
1829 
1830 


Mitiiiiiiiiitiitititiiiiiieiissii tii ttt ett o es a 

! 

| 

! 

! 

| 
1831 ! QUTFUT: RLO = 1ST CHAR IN CONIRF 

| 

! 

! 

l 

| 

| 

| 


! 
FETCH SINGLE INPUT LINE IN CONIBF sMAXIMUH 80 CHARACTER! 
& LINE IS TERMINATE BY CR, ALL CHARACTERS RECEIVED  ! 
HAVE BEEN CONVERTED TO UPPER CASE AND ECHOED TO TTY 


1832 RETURN Z IF CHARACTER IN RLO IS CR 
1833 
1834 
1835 
1836 
183? 
1838 


(STILL POINT TO 1ST CHAR) 


wee RO Rly R2 ARE LOST Hath 


1 
1 
| 
INPTR = CONIBF PTR TO FETCH NEXT INPUT CHAR | 
| 
1 
| 
1 
i 


200000 HHHH HHH 0H BBG 
1839 
1840 ENTRY 
0700 2102 1841 R2» #CONIBF 
074 2101 1842 Ris #CISIZE 
0706 4F02 1843 INPTR? R2 1 CONIBF INPUT POINTER! 
O7CC DOAZ 1844 TTY { INPUT LINE IN CONIBF! 
O7CE SEQ6 1845 Zr EROR ! EROR» TOO HANY CHAR ! 
0702 D041 1846 SKIPSP ! SKIP OVER BLANK & DON’T ! 
1847 ! UPDATE INPTR ! 
0704 B00 1848 INPTR 
0708 0A08 1849 RLO, #ASCICR | 1ST CHAR IN RLO» COMPARE! 
O70 9E08 1850 ! WITH CR! 
O7DE 1851 END GET 
1852 


511 


512 


O7DE AL0Z 
07E0 A900 
07E2 0800 
0766 EEO1 
07E8 8008 
O7EA 9102 
O7EE E08 
O7FO 


07F0 


07FO A102 
07F2 A900 
07F4 0800 
O7F8 EEO! 
O7FA 808 
O7FC 0102 
0800 9E08 
0802 


0802 


0100 


4180 


0100 


4250 


1853 

1854 GLOBAL GBFADR PROCEDURE 
1855 
1856 
1857 
1858 
1859 


Mtsttttitiiiitiiiiiisiiitiiii tii itt itis et et 

! 

! 

! 
1860 ! INPUT: RO = OFFSET TO RINGBF 

' 

! 

1 

| 

! 


GENERATE ADDRESS OF RINGBF 70 STORE OR GET NEXT CHAR 


1861 
1862 
1843 
1864 
1865 
1866 
1867 ENTRY 

1868 R2y RO 

1869 RO, #1 1 INC OFFSET ! 

1870 RO, @RBSIZE ! WRAP AROUND IF HIT END! 
1871 NZ» GENL 

1872 RO ! RESET OFFSET =0 ! 

1873 GENL: ADD R2> #RINGBF ! CALCULATE ADDRESS! 
1874 RET 

1875 END GBFADR 

1876 

1877 

1878 GLOBAL WCZADR PROCEDURE 

1879 


QUTPUT: RO = OFFSET TO RINGBF FOR NEXT CHAR 
R2 = ADDRESS OF RINGBF 


JEHHEBB HEHE HBEHEB BEB BBEB HEHEHE HE BBHEHHE HE HEHEHEHEE 


1880 | HHHHBHBHHHB HBO NHEHEBHHEEOBOHOBOHHBHEHBECHEBHEBBBHHHHE | 


1881 ! 


1882 | GENERATE ADDRESS OF HCZBUF TO STORE OR GET NEXT CHAR. 


1883 ! 

1884 ! INPUT: RO = OFFSET TO MCZBUF 
1885 ! 

1886 ! QUTPUT: RO = UPDATED OFFSET 
1887 ! R2 = ADDRESS OF MCZBUF 
1888 | 


Mt titiiiiiitiiiiiiiiisiietititiiiiitit ttt iiii itt ts 


1890 

1891 ENTRY 

1892 LD R2y RO 

1893 INC RO» #1 ! INC OFFSET ! 

1894 CP RO» @#RBSIZE ! WRAP AROUND IF HIT END! 
1895 AR NZ» GENX 

1896 CLR RO ! RESET OFFSET =0 ! 
1897 GENX: ADD R2y #MCZBUF ! CALCULATE ADDRESS! 
1898 RET 

1899 END MCZADR 

1900 ! PAGE EJECT ! 

1901 

1902 GLOBAL PTYINT PROCEDURE 

1903 


1904) | eH EEEEEEHBHBE EH HHEHHHHHEEERHHBHEHHEBBHHEHHE | 
1905 | 
1906 ! INTERRUPT INPUT ROUTINE, SAVE ALL USER REGISTERS. 
1707 ! RECEIVE ONE CHARACTER FROM SERIAL LINE. 


1908 
1909 
1910 


! IF SYSTEM IS NOT IN TRANSPARENT HODE, THEN CHECK IF 

I 

! 
LLL ! 

! 

| 

! 

! 


! 
! 
| 
! 
XOFF OR XON CHARACTER IS RECEIVED, SET OR RESET BIT ! 
IN CFLAGS WORD. ! 
! 
! 
! 
! 


1912 
1913 
1914 
1915 
1916 
1917 ENTRY 
0802 93F0 1918 PUSH = BRIS, RO 
0804 93F1 1919 PUSH = @RLSy RL 
0806 93F2 1920 PUSH = @R15)_-R2 
1921 
1922 ! READ CHARACTER AND CHECK FOR XON XOFF CHAR ! 
1923 
0808 3A94 1924 RL1r SIODB 
O80C A297 1925 RLiy PARITY ! READ CHAR FROM TTY! 
1926 
O80E 6700 1927 CFLAGS, #TRNMDE ! DON’T CHECK XON/XOFF! 
0812 EE18 1928 NZ» SVCHR ! IF IN TRANS.MDE ! 
0814 4809 1929 RLir XONCHR ! RESET BIT IF XON ! 
0818 EE03 1930 NZ CKOFF 
081A 6302 1931 CFLAGS, #OUTHLD ! RESET BIT SO ROUTINE ! 
1932 1 TYR RESUME OUPUT ! 
OB1E E818 1933 OUTS 
1934 CKOFF: 
0820 4809 1935 RL» XOFCHR ! SET BIT IF XOFF ! 
0824 EEQ3 1936 NZ, CKESC 
0826 4502 1937 CFLAGS, BQUTHLD ! SET BIT SO ROUTINE ! 
1938 ! TYWR STOP OUTPUT ! 
082A £812 1939 OUTS 
1940 
1941 CKESC: 
0820 OA0? 1942 RL FESCHAR 
0830 EE0? 1943 NZ+ SVCHR ! NOT ESCAPE KEY ! 
0832 6703 1944 CFLAGS» $SNDMDE ! YES» CHECK IF IN SEND ! 
0836 EE03 1945 NZ, SETFG 
0838 6704 1946 CFLAGS #LODMDE ! CHECK IF IN LOAD ! 
0830 £403 1947 Z1 SVCHR ! NO, JUST SAVE ESCAPE ! 
OB3E 4505 1948 SETFG: CFLAGS » #ESCAPE 
0842 £806 1949 QuTS ! SET BIT INDICATE ESCAPE! 
1950 1 PRESSED IN LOAD/SEND ! 
1951 
1952 SVCHR: 
0844 6100 1953 RO» TTYPUT 
B48 DOI6 1954 GBFADR ' CALC ADDR OF RINGBF ! 
084A 4F00 1955 TTYPUT, RO! UPDATE OFFSET ! 


QUTPUT : SET/RESET BIT IN CFLAGS IF RECEIVE XON/XOFF 
STORE CHARACTER IN RINGBF & UPDATE TTYPUT 


(HBB HE HHBHEBIBBEHBEBHBIIEHHHHEEBBBEEBHBBEEEBBBBHEBHEE | 


513 


514 


OB4E 2E29 


0850 2101 
0854 3AI6 


0858 97F2 
OB5A 97F1 
0850 97FO 
O8SE 7800 


0860 


0860 


0860 93F0 
0862 93F1 
0864 93F2 


0866 3A94 
OB6A A297 


OBC 6100 
0870 BO41 
0872 6F00 
0876 229 


0878 2101 
0870 3A% 
0880 97F2 
0882 97F1 
0884 97F0 
0886 7800 


0888 


FFLY 


4308 
4308 


0038 
FFID 


1956 @R2, RL! -GET CHAR IN RINGBF! 
1957 

1958 OUTS: 

1959 Riy #40038! BIT Ort/2 WRITE REG 0 ! 
1960 1 BIT 3-5 RETURN FROM INTER! 
1961 SIOCAy RL 

1962 

1963 R2r BRIS 

1964 POP Rtv @RIS 

1965 POP ——ROy RIS 

1946 IRET 

1967 

1968 END PTYINT 

1969 ! PAGE EJECT ! 

1970 

1971 GLOBAL HCZINT PROCEDURE 

1972 

OPAMP iiiiiitiiiititititiiiiiiiitiiiiiiiiittititititi +? ta 
1974 ! 
1975 ! INTERRUPT ROUTINE FOR INPUT FROM HCZ (CHANNEL A)! 
1974 | RECEIVE ONE CHARACTER FROM SERIAL LINE. 
1977 ! 
1978 | QUTPUT : STORE CHARACTER IN HCZBUF & UPDATE HCZPUT ! 
1979 ! ; 
1980 | AHHEHE HHH HHE BEE HEHHE BEEBE EEEHEEHEHBBEEEHHHEE 1 
1981 

1982 ENTRY 

1983 PUSH —@RISy RO 

1984 PUSH RIS) RI 

1985 PUSH — @RLSy R2 

1986 

1987 | INPUT CHARACTER FROM SIO CHANNEL A ! 

1988 

1989 INR RL STODA 

1990 RESB —RLiy @PARITY ! READ CHAR ! 

1991 

1992 LD RO» -HCZPUT 

1993 CALR HCZADR | CALC ADDR OF MCZBUF ! 

1994 LD —sHCZPUT» RO! UPDATE OFFSET ! 

1995 LDB =» @R2y RLL=— st SAVE CHAR IN HCZBUF! 

19% 

1997 LD Ry #20038! BIT Or1r2 WRITE REG 0 ! 
1998 | BIT 3-5 RETURN FROM INTER! 
1999 QUTB —SIOCAr RLI 

2000 

2001 POP —R2y RIS 

2002 POP Rtv BRIS 

2003 POP RO, @RIS 

2004 IRET 

2005 

2006 END HCZINT 

2007 


0888 93F 1 
088A 2101 
OBBE 30% 
0892 2101 
0896 3A% 
089A 97F1 
0B9C. 7800 
089E 


OBIE 


O89E 93FL 
OBAO 2101 
O8A4 3A% 
OBAB 2101 
OBAC SAI 
08B0 97F1 
O8B2 7800 
O8B4 


08B4 


0030 
FFF 
0038 
FFill 


0030 
FFLD 
0038 
FFLD 


2008 


2011 ! 


2007 GLOBAL CHBSRC PROCEDURE 
2010 


JOOHEHE GHEE BE HBB HBB BBE HHHBBE EHH HEBBEBBBEBBHBE | 


2012 ! 

2013 | CHBSRC RESET SIO CHANNEL B FOR SPECIAL RECEIVE | 

2014 ! CONDITIONS: PARITY ERROR, RX OVERRUN ERROR» FRAMING | 
"2015 | ERROR» END OF FRAME. 

2016 ! 

2017 |! JEHUBHBHB DHE H EH BBEEBEBHEBE HBB HEHEHE EEE HEE ! 

2018 

2019 ENTRY 

2020 PUSH @RIS RI 

2024 LD Ry #430! BIT 324e5 ERROR RESET ! 

2022 OUTB = STOCBy RL 

2023 LD RL #438-=—s! «BIT 3045 RETURN FROM | 

2024 QUTB = STOCAy RL1. «=! “INTERRUPT ! 

2025 POP RL BRIS 

2026 IRET 

2027 END CHBSRC 

2028 

2029 

2030 GLOBAL CHASRC PROCEDURE 

2031 

2032 ! JEHBBRIBHEBEHE HEHE HGH EHH HB HHEGBHHEIHEGHEEEEEEEEE I 

2033 ! | 

2034 ! CHASRC RESET SIO CHANNEL A FOR SPECIAL RECEIVE 

2035 |! CONDITIONS: PARITY ERROR, RX OVERRUN ERROR, FRAMING | 

2036 ! ERROR, END OF FRAME, 

2037 ! 

FIRM tiitiitiisiitiitiiiiiiiitiiiititetsiettttstt tt tts 4 ! 

2039 

2040 ENTRY 

2044 PUSH @RIS RI 

2042 LD sR 8%30=—— BIT 34/5 ERROR RESET ! 

2043 QUTB © STOCAy RL 

2044 LD Rt 8738 =}: BIT 374y5 RETURN FROM ! 

2045 QUTB = SIOCAy RL1. =! INTERRUPT ! 

2046 POP Ry BRIS 

2047 IRET 


2048 END CHASRC 
2049 | PAGE EJECT ! 


2050 


2051 GLOBAL PUTMSG PROCEDURE 


2052 


515 


516 


O8B4 2101 
0888 8D08 
O8BA 2028 
O8BC 8101 
OBBE 6F01 


O8C2 A920 
0804 2101 
O8CB BA21 
O8CC 5E08 


0800 


O8D0 DOCS 
0802 DOD? 
O8D4 £608 
O8DS ALSS 


4130 


2053 
2054 
2095 
2056 
2057 
2058 
2099 
2060 
2061 
2062 
2063 


1) JHEEEEHEHEE HEHEHE HEHEHE HEEB BRIBE | 
! ! 
! PUT QUT MESSAGE POINTED BY R2, 1ST BYTE OF MESSAGES 1S! 
1! THE LENGTH OF THE MESSAGE IN BYTE ! 
! 


{ INPUT! R2 = ADDRESS OF MESSAGES 
| QUTPUT: ROsRI/R2 ARE LOST i 
1896 36 9 98 3 8 0 i 0 a a I 


2064 ENTRY 


2065 
2066 
2067 
2068 
2069 
2070 
2071 
2072 
2073 
2074 
2075 


Riv #CONOBF 
! # OF BYTE OF MESSAGE! 
QUTPTR» Ri 
R2 
Riv #CONOBF 


G@Riy @R2, RO ! TRANSFER DATA TO CONOBF! 
PUTNER 


2076 END PUTHSG 


2077 
2078 


2079 GLOBAL LOD2 LABEL 
2080 GLOBAL LOD3 PROCEDURE 


2081 
2082 
2083 
2084 
2085 
2086 


JEHBHBHHHE HEEB HHEHEEI EEE BEEBE BEEBE EHEBE 1 


CONIBF BUFFER. THE ASCII ARGUMENTS ARE CONVERTED 
TO HEX ADDRESSES. 
! LOD2 EXPECTS THO ARGUMENTS AFTER THE COMMAND. 
| 
! QUTPUT + (LOD3) RS - 1ST ARGUMENT, R4 - 2ND ARGUMENT ! 
RS - SRD ARGUMENT ! 
(LOD2) R4 - 1ST ARGUMENT, R3 - 2ND ARGUMENT ! 


| 
! 
! LODS EXPECTS THREE ARGUMENTS AFTER THE COMMAND IN 
! 
! 


RETURN C FOR INSUFFICIENT ARGUMENTS 
RETURN NC FOR RECEIVING CORRECT ARGUMENTS 


1 ea RO» RO ARE LOST see 


| 
! 
! 
! 
! 
1 
! 


6 0 98 8 6 98 8 9 9 0 9 9 9 0 i 


CALR —sNXTARG ! SKIP COMMAND TO NEXT CHAR! 
GETADN ! GET 15T ARGUMENT IN R3 ! 
Z) ERNS 1 CAN’T BE CR» EXPECT MORE! 
RSr RS 


08D8 E801 


O8DA BOCA 
O8DC DODE 
OBDE £603 
O8EO A134 


O8E2 DOEL 
OBE4 9EQF 


OBES 8DB1 
O8E8 9E08 


O8EA 


O8EA BD64 
OBEC 2101 43F2 
O8FO E814 


O8F2 


O8F2 BDOE 
O8F4 2105 0E7C 


O8F8 6102 4384 


2105 JR LX2 

2106 

2107 LOD2: 

2108 CALR =—-NXTARG ! SKIP OVER COMMAND ! 

2109 LX2: 

2110 CALR —-GETADN ! GET 2ND ARGUMENT ! 
aiil JR Z » ERNS ! ERROR, CR AFTER 2ND ARGU. ! 
2112 LD R4rR3 ! SAVE 2ND ARGUMENT 

2113 

2114 CALR —- GETADN ! GET SRD ARGUMENT ! 
2115 RET NC ! GOT ARGUMENT ! 

2116 

2117 ERNS: SETFLG C ! RETURN C FOR ERROR ! 

2118 RET ! ARGUMENT MISSING ! 

2119 

2120 END LOD 

2121 

2122 

2123 

2124 GLOBAL PUTRG2 PROCEDURE 

2125 

2126 | JH BHHHHEHEHHEHBBEBOCEHEG HEEB HBHE HBB BEBE BEEBE | 
2127 ! 

2128 ! PUTRG2 PRINTS THE CONTENTS OF REGISTER 14) 15 

2129 |! CURRNET PC AND FCW 

2130 ! ! 
2031 | HEAHG BREE HEBEEE RO HHHHHEE HEHEHE SEE | 
2132 ENTRY 

2133 

2134 LDK Ror 4 ! € OF REGISTER ! 

2135 LD Ri, #Ri4_ | ADDRESS OF R14 ! 

2136 JR DL2P 

2137 

2138 END PUTRG2 

2139 

2140 

2141 

2142 GLOBAL RHEDL PROCEDURE 

2143 

7144 | JHEHHEHHHEBHEIBHHBHHBHBBBBHEBH HEHEHE a BEE BHBHEE | 
2145 ! 

2146 ! RHEDL PRINT REGISTER 0-13 HEADER 

2147 ! 
2148 ! 
2149 ! 
2150 ! 
2151 

2152 ENTRY 

2153 LDK ROr#14 ! PRINT LITERAL RO-R14 
2154 LD RS» #LRO ! REG LITERAL TABLE ADDR ! 
2155 

2156 DLOP: ~=LD R2, OUTPTR | CURRENT CONOBF ADDR ! 


wt ROD Rip R2 ARE LOST 


JOHHBHO HBB EBHEBHBH BEBE HOHEH HB HEHEBHBHB GHEE HEEEHE | 
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O8FC 0C25 9252 


0900 6900 4336 
0904 2151 
0906 D264 
0908 ABOO 
090A E635 


0900 6901 
0910 A9SL 
0912 E8F2 
0914 


4386 


0914 


0914 BOSE 
0916 2101 
OFLA 2115 
OPC DFFS 
OP1E ABGO 
0920 E62A 


0922 6900 
0926 APLL 
0928 E8F8 


092A 


O92A BIO4 

0720 2105 OE98 
0930 E8E3 

0932 
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2157 LDB 
2158 
2159 INC 
2160 LD 
2161 CALR 
2162 DEC 
2163 JR 
2164 
2165 INC 
2166 INC 
2167 UR 
2168 END RHEDL 
2169 
2170 
2171 GLOBAL PUTRG1 PROCEDURE 
2172 
2173 ! 
2174 ! 
2175 |! PUTRG1 PRINTS CONTENTS OF REGISTER 0 TO 13 
I 
i 


@R2, #7R? 


OUTPTR 
Ri» @R5 
STRRGI1 
RO, #1 

Z1 PUTPTR 


! GET LITERAL ! 

! STORE IN CONOBF ! 

1 CHECK IF ALL DONE ! 

! YES» PRINT CONOBF RETURN! 


OQUTPTR» €2 
Ry #2 
DLOP 


! ADD 2 SPACE ! 
! ADVANCE LIT TABLE ADDR! 


JAHHBHHB BBE EEEHHB EHH BHU BHHHHHEHEBHEHEHEEBHBHE | 


2176 
2177 
2178 
2179 ENTRY 

2180 

2181 

2182 DL2P: 

2183 

2184 

2185 

2186 

2187 INC 
2188 INC 
2189 JR 
2190 

2191 END PUTRGI 
2192 

2193 

2194 GLOBAL RHED2 PROCEDURE 

2195 

2.194 | JUHHH}HBBBHBHEEEEEEEEEEEEEEEEEEEEHEHEBEEEEEHEHEEHEBHE 
2197 ! 

2198 |! RHED2 PRINTS THE HEADER FOR REG 14, REG 15, PC & FCH 
2199 ! I 
2200 | JBBHBHEHEOBHBREHHBOHEHHEHBHBHBEH ABH HHEEBEHEEBOHBAHE  [ 
2201 

2202 ENTRY 

2203 LDK 
2204 LD 
2205 JR 
2206 END RHED2 
2207 

2208 


JHBUHEEBEHBUBHHBBEH HE HHBHEB BEBE HHH BHHEBEHEHE | 


Ror #14 ! $ OF REGISTER | 
Ri» #RO_ ! REGISTER CONTENT ADDRESS ! 
Roy @Ri ! CONVERT REGISTER CONTENT ! 
PUT2 ! TO FOUR 8-BIT ASCII CHAR! 
Ror #1 ! CHECK IF BONE ! 


Zr PUTPTR =! PRINT CONOBF, RETURN ! 


QUTPTR: #1 
Rly #2 
DL2P 


! SPACE ! 
! NEXT REG CONTENT ADDRESS! 


RO» #4 
Roy #LR14 
DLOP 


! $ OF REGISTER ! 
! ADDRESS OF LITERAL ! 


0932 A050 
0934 DFFF 


0936 A0DO 


0938 BEO8 
093A DFFF 
0930 BEOS 


OF3E 0408 
0942 BOBB 


0944 OA0B 
0948 £702 
074A 0008 
O94E 0008 


0952 93FL 
0954 6101 
09758 2618 
O95A 6900 
O95E 97F1 
0960 9E08 


2209 GLOBAL PUTI LABEL 


2210 


2211 GLOBAL PUT? PROCEDURE 


2212 


2213 ! 
2214 ! 
2215 ! 
2216 ! 
2217 ! 
2218 ! 
2219 ! 
2220 ! 
2221 ! 
2222 ! 
2223 ! 
2224 ! 
2225 ! 
2226 ! 
2227 | 
2228 ! 
2229 ! 
2230 ! 
2231 ! 
2232 ! 
2233 ! 
2234 ! 
2235 ! 


2236 


JAHHHEHHEBHBHBHBBBEBBHHHBBHBEHE HEHEHE BHEEEHE | 


PUT2 CONVERTS FOUR 4 BITS HEX VALUE IN RS TO FOUR 
8 BIT ASCIT CHARACTER AND STORE THE IN CONOBF. 
QUTPTR ISINCREMENTED BY 4 WHICH POINTED TO THE NEXT ! 


EMPTY BUFFER 


EACH 4 BIT HEX VALUE IS ALSO ADDED TO AN ACCUMULATOR ! 


RL3 BEFORE THEY ARE CONVERTED TO ASCII CHARACTERS 
(USED BY LOAD/SEND» PUNCH/TAPE) 


PUT1 CONVERTS THO 4-BITS HEX VALUE IN RLS 


INPUT! RS = 16 BIT VALUE (PUT2) 
RLS= 8 BIT VALUE (PUTL) 
RL3= 8 BIT ACCUMULATOR 


QUTPUT: RL3= UPDATED ACCUMULATOR 
THO OR FOUR ASCII CHARACTERS STORED IN CONOR 
OUTPTRINCREHEHT BY 2 OR 4 


#8 RO TS LOST we 


JHBBHHHHHHEHH HHH BH HEHEHE BEEBE BBHHEHHEHEBEEE 


2237 ENTRY 


2238 
2239 
2240 


LDB 
CALR 


2241 PUTS LDB 


2242 


2243 PUTA: —RLDB 


2244 
2245 
2246 


CALR 
RLDB 


2247 INVCON: ANDB 


2248 
2249 
2250 
2251 
2252 


2253 NOADD: 


2254 
2255 
2256 
2257 
2208 
2259 
2260 


RHO» RHS 
PUTA 


RHO» RLS 


RLO»RHO 
INVCON 
RLO, RHO 


RLO, #Z0F 
RL3, RLO 


RLO? #Z0A 
Cy NOADD 
RLO? #7 
RLO» #230 


BRIS, Ri 
Ri, QUIPTR 
@R1i» RLO 
OUTPTR 

Rip @RIS 


! CONVERT 1ST BYTE 


! CONVERT LOWER BYTE 
! CONVERT 4 BITS/. TIME 
! NEXT 4 BITS 


! ONLY USE 4 BIT 
| ADD VALUE TO ACCUHULATOR! 


1 CK FOR 10-15 VALUE ! 
! CHANGE TO ALPHA | 
! CONVERT TO ASCII ! 


! CONOBF OFFEST 


. 
! 
! 
! 
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2261 
2262 END PUT2 
2263 
2264 
2265 
2266 GLOBAL NULL PROCEDURE 
2267 
2268 | JHHHHBHBBHBHEHEBEEHHHHHHHHB BESS HO GBH BEB BEBBHEAEE | 
2269 ! ! 
2270 ! MULL OUTPUT A SEQUENCE OF NULL CHARACTERS. NULLCT IS ! 
2271 ! THE COUNT OF NULL CHARACTER. ! 
2272 ! ! 
2273 | JHHBHB HBB BBB IHHBEHBBBEEHBB EA HBHBEEHHHHHEEHEHHEHEHE | 
2274 
2275 ENTRY 

0962 4004 43BC 2276 TEST = NULLCT 

0966 E06 2277 RET ue ! NO NULL CHAR ! 

0968 6101 43BC 2278 LD Ris NULLCT ! PUT QUT NULL CHAR ! 

0960 8008 2279 CLR 

O96E DOFD 2280 SNULL: CALR 
2281 1 DUNZ 

0970 ABLO 

0972 EEFD 

0974 9€08 


0976 


2290 GLOBAL PUTNCR LABEL 
2291 GLOBAL PUTPTR PROCEDURE 
2292 
POARMMME Liisi tiiiiiiiiiiiiiiiiiiiiititiititiiiitttiittiti st a 
2294 | 
2295 | PUTPTR OUTPUT CHARACTRS IN CONOBF TO TTY WITHCR =! 
2296 | ADDED TO THE END OF CHARACTER STREAM. UTPTR IS THE ! 
2297 | ADDRESS OF CONOBF CONTAINING LAST CHARACTER. 
2298 |! 
2299 | PUTNCR OUTPUT CHARACTER STREAM IN CONOBF. 
2300 ! 
2301 ! INPUT: CONOBF - BUFFER WITH CHARACTERS 
2302 ! QUTPTR - CONOBF POINTER OF THE LAST CHAR. — ! 
2303 ! 
2304 | OUTPUT: OUTPTR=#CONOBF, CONOBF BUF FILL WITH BLANK | 
2305 ! ! 
2306 | #HE RO, Riy R2 ARE LOST ene 
2307 ! 
2708 | JaHRHBBHBBEBHHAHEBHBBBHBHBBHBEHHHBBHBHBEBHBBBEHBHEAHBE 1 
2309 
2310 ENTRY 
0976 6102 43B6 2311 LD ——sR2 QUTPTR 
097A 0C25 DOD 2312 LDB -@R2y #ASCICR | STORE CR IN CONOBF ! 
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O97E 6900 2313 INC OUIPTR» #1 ! ADVANCE CONOBF PTR ! 
2314 
0982 2101 2315 PUTNCR: LD Ri, $CONOBF 
23516 
0986 2018 2317 QUTLOP: LDB RLO, GR1 
0988 A910 2318 INC Ri 
098A D1OB 2319 CALR = TYWR ! PUT OUT CHAR ! 
O80 E604 2320 AR Z> PUTLF ' NO, CK IF PUT OUT CR! 
O98E 4B01 2321 CP Ri» QUTPTR ! CHECK IF ALL DONE ! 
0992 E7F9 2322 JR > QUTLOP ! NOT YET ! 
0994 £804 2323 JR BINT ! DONE, RESET POINTER ! 
2324 
2325 PUTLF? 
0996 C80A 2326 LDB RLO, #ASCILF ©! YES, ADD LF ! 
0998 D112 2327 CALR = TYWR 
2328 
099A SFOO 2329 CALL == NULL ! PRINT NULL CHAR ! 
O99E 4005 2330 BINT: = LD QUTPTR: SCONOBF! RESET CONOBF POINTER ! 
OPA2 4130 
O9A4 2102 2331 LD R2,#C0SIZE/2 =! INIT CONOBF WITH BLANK ! 
O9AB 4D05 2332 LB CONOBF, #? ? 
OPAC 2020 
OFAE 2100 2333 LD RO, #CONOBF 
09B2 2101 2334 LD Ri» #CONOBF+2 
09B6 BBOL 2335 LDIR = @R1 BRO, R2 
O9BA 9E08 2336 RET 
2337 
O9BC 2338 END PUTPTR 
2339 
2340 ! PAGE EJECT ! 
2341 
2342 GLOBAL IOPORT PROCEDURE 
2343 
2344. | OHH G BANNER HEHEHE BBBBBEBBBEE HBO HBBHEBBBBBBBE | 
2345 ! | 
2346 |! PORTRW PERFORMS PORT READ & WRITE FUNCTIONS EITHER  ! 
2347! IN BYTE OR WORD. DEFAULT TO BYTE READ & WRITE | 
1 
! 


2349 | SYNTAX! PORT <PORT ADDR.) CHIBI 
2350 ! ! 
2351 | JHHHE HH HHHEHHEBHHBHHBHHHB HBA EHH GHB HEHEHE HEHEHE 
2352 
2353 ENTRY 
OBC D138 2354 NXTARG 
OFBE 5E06 2355 Zr EROR ! NO ADDRESS ! 
09C2 D151 2356 GETADN 
0904 A136 2357 Rér RB ! SAVE PORT ADDR ! 
09C4 E607 2358 Zr GOTCR 
0908 OA08 23559 RLOy #7? ! NEXT CHAR IN RLO ! 
OCC ESB 2360 Z1 PRHORD ! READ IN WORD ! 
O9CE OA0B 2361 RLO» #78? 
O9D2 SEOE 2362 NZ, EROR 


2348 ! ! 
I 
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09D 8078 
O9D8 304? 


O9DA A165 
O9DC D056 
O9DE 6900 
O9E2 ALLS 
O9E4 8074 
O9EG £402 
O9E8 DOSC 
O9EA E801 
O9EC DOSC 


OVEE 6900 
O9F2 D039 
O9F4 D1DO 
O9F4 9E07 
O9F8 8074 
O9FA £402 
OFC 3FS3 
OPFE 9E0B 
OAOO SE6B 
OA02 9EOB 


OA04 BD71 
OA06 3061 
OAOB EBEB 


OAOA D099 
OAOC 5E07 
OALO AL48 
OAL2 A137 
OA14 8387 


2363 

2364 GOTCR: CLR R7 

2365 INB RLiy @R6 
2346 


INDICATOR FOR BYTE/WORD! 
READ DATA IN BYTE ! 


2367 ! DISPLAY PORT ADDRESS & THE DATA ! 
R7=1 READ WORD ! 


2348 1 R7=0 READ BYTE: 
2369 

2370 PX: RSr RS 
2371 PUT2 
2372 OUTPTR 
2373 Roy Ri 
2374 R7 

2375 Z+ PUTBYT 
2376 PUT2 

2377 POUT 

2378 PUTBYT: CALR = PUTL 

2379 POUT: 

2380 INC 
2381 CALR 
2382 CALR 
2383 RET C 
2384 TEST =—-R7 
2385 JR 
2386 OUT 
2387 RET 
2388 WBYTE: OUTB 
2389 RET 
2390 

2391 PRHORD: LOK R7> #1 
2392 IN Ri» @Ré 
2393 JR PX 
2394 

2395 END IOPORT 

2396 | PAGE EJECT ! 

2397 
2398 GLOBAL PUNCH PROCEDURE 
2399 


OUTPTR 
PUTNCR 


GR, RS 
Ry RL3 


! OUTPUT PORT ADDRESS! 


1 QUPUT DATA BYTE OR WORD! 


! OUTPUT CONOBF ! 
! GET NEW DATA ! 
1 RECEIVE ’Q? ! 


! REPLACE WITH NEW CONTENTS! 


READ DATA IN WORD ! 


2400 | JHHHHBHEHHBB HH HBHBHBHBHBEE BBS HEBEBBEEEBHAHHEHBHHE | 


2401 ! 


2402 ! PUNCH IS USED TO PUNCH A PAPER TAPE COPY OF THE 


2403 ! 
2404 | 
2405 ! 
2406 ! 
2407 ! 


! 
! 
PROGRAM IN MEMORY FROM THE STARTING ADDRESS 10 ! 
ENDING ADDRESS SPECIFIED BY (BEG.ADDR) & CEND ADDR) ! 
THE PUNCH WILL BE TURNED ON AUTOMATICALRYs AND THE ! 
! 
| 
! 


PROGRAM WILL BE PUNCHED IN TEKTRONIX FORMAT. 


2408 | dak GHBHAHHHBBHRBHHBHEHBBEEBHEBBHEBB BEBE BEHBBBEE HEHE 


2409 ENTRY 

2410 CALR = LOD2 
24i1 JP Cy EROR 
2412 LD RE, R4 
2413 LD R7y R3 
2414 SUB R71 RB 


MISSING ADDR ! 
STARTING ADDR ! 
ENDING ADDR ! 


OAL6 5E07 
OALA A970 


OALT CBi2 
OALE D155 
OA20 DFBC 


OA22 0807 
OA26 EFO3 
OA28 AL79 
OA2A 8D78 
OA2C £804 
OA2E 2109 
OAS2 0307 


OA36 2102 
OASA DEES 
OASC EEF2 


OASE 8D68 
OA40 2102 
OA44 DED2 
OA46 DFCF 
OA48 C814 
OA4A D1dB 
OAAC 9E08 


OA4E 


OA4E 


OA4E (B11 
OASO DL6E 


OAS2 D17B 
OA5S4 OA08 
OASB EEFC 


2415 Cy EROR ! ENDING ADDR TOO SMALL ! 
2416 R? 

2417 

2418 RLO, $TAPON =! PUCH TAPE ON CHAR ! 

2419 TYHR 

2420 NULLTP ! TAPE LEADING CHAR ! 

2421 

2422 NXTRC: R71 #30 

2423 ! SEND 30 BYTE ! 

2424 ! SEND ¢ 30 BYTE ! 

2425 

2426 

2427 $30: RP? $30 

2428 R7, #30 

2429 

2430 RSDD: R2,#PUTPTR ©! SEND DATA TO TERMINAL ! 
2431 | RECSND 

2432 NZ+ NXTRC ! SEND MORE ! 

2433 

2434 Rb ! ADDRESS = 0 ! 

2435 R2, #PUTPTR 

2436 LASREC 1 GEND LAST RECORD-TERMINAL ! 
2437 NULLTP ! LEADING CHAR AT TAPE END! 
2438 RLO» #TAPOFF ! PUNCH TAPE OFF ! 

2439 TYHR 

2440 

2441 

2442 END PUNCH 

2443! PAGE EJECT ! 

2444 

2445 GLOBAL TAPE PROCEDURE 

2446 
2447 
2448 
2449 


JE HBB BBE H HEHE EBT BEBE HHHHEE EI HHEEE EEE HEEE | 


! 

! | 

1 TAPE LOADS A PAPEER TAPE AND STORES DATA INTO MEMORY ! 
2450 ! TURN ON THE READER AND THE DATA ON TAPE IS IN 

! 

! 

! 


TEKTRONIX FORMAT. AFTER THE END OF TAPE, TURN OFF 
THE TAPE & MESSAGE PRINTED 


2451 
2452 
2453 | 
2454 | JHHHA HEHE GHHO HEHEHE HHHOHHEH HOHE O BEEBE BEHEBHE [ 
2459 ENTRY 

2496 

2497 LDB RLO» #XONC 

2458 CALR —TYWR ! SEND XON TO START TAPE ! 
2459 

2460 ! RAIT FOR A ?/’ TO BEGIN STORING CHARACTER INTO ! 
2461 ! CONIBF. CONIBF DOES NOT INCLUDE ’/’. ! 

2462 

2463 WATCT: 

2464 CALR —-TYIN 

2465 CPB = RLOs #77? ! WAIT UNTIL '/? ! 

2466 JR NZ» WATCT 


323 
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OASA 2104 
OASE CBSO 


OA60 D182 


OA62 2648 
OA64 0A08 
OAGB E60B 
OAGA OA08 
OAGE ESF8 
OA70 AP40 
0A72 FBOA 


OA74 Di8C 
A746 OA08 
OA7A EEFC 


OA7C 6E08 


OA8O C813 
OAB2 D187 


OAB4 DF32 
OAG6 E704 


OARS 8C34 
OABA E606 
OAC DEEF 
OABE E8DF 


OA D179 
OA92 2102 
OA96 DOF2 


OA9B 2191 
OAIC ABO 
OAIE EEFE 


OAAQ 4008 
OAA4 4008 


2467 
2468 LD 
2469 LDB 
2470 
2471 


R4r SCONIBF 
RL3y #80 


! MAX GET 80 CHARACTER! 


2472 1 START STORING CHARACTER, IGNORE CONTROL CHAR ! 
2473 ! ALSO CHECK FOR CARRIAGE RETURN FOR END OF RECORD ! 


2474 
2475 LCO: = CALR 
2476 
2477 
2478 
2479 
2480 
2481 
2482 
2483 
2484 
2485 


TYIN 


R4, RLO 
RLO, #ASCICR 
Z1 SXOFC 
RLO, #! ! 
HILCO 

R4y #1 

RL3y LCO 


! STORE CHAR ! 

! CHECK FOR END OF RECORD ! 
1 YES» STOP THE TAPE ! 

! IGNORE CONTROL CHAR! 


! GOOD CHARACTER ! 
! DECREMENT CHAR COUNT ! 


2486 ! ALREADY RECEIVE 80 CHARACTERS, SKIP OVER ALL ! 
2487 ! CHARACTERS UNTIL CARRIAGE RETURN. ! 


2488 

2489 LOC2: CALR 
2490 CPB 
2491 JR 
2492 

2493 

2494 

2495 SXOFC! 


2512 TAPFIN: 
2513 LD 
2914 WATT: 

2515 JR 
2516 

2517 CLR 
2918 CLR 


TYIN 
RLO» #ASCICR 
NZ, LOC2 


! REST OF CHAR EXCEPT CR ! 


CONTBF+80/RLO ! GOT CR ! 


RLO, $XOFFC 
TYHR 


REKCKS 
Cy BDATA 


RH3 
Z,TAPFIN 
STREC 
TAPE 


CRLF 
R2) #BADAT 
PUTHSG 


RL RLFFFE 
RLF 
NZr RATT 


TTYPUT 
TTYGET 


! SEND XOFF TQ STOP TAPE ! 


! CHECKSUM BAD ! 


1 CHECK IF LAST RECORD! 
1 YES ! 
! STORE DATA IN MEMORY ! 


! MESSAGE FOR BAD DATA! 
! ABORT & BACK TO DEBUG ! 


! WAIT FOR A WHILE BEFORE ! 
! EMPTY INPUT BUF, IN ! 

! CASE RECEVIED EXTRA CHAR! 
! BEFORE XOFF SEND QUT ! 


1 CLEAR INPUT BUFFER ! 


OAAB 9E08 
OAAA 


OAAA 


OAAA C932 
OAAC BD08 
OAAE D19D 
OABO F902 
OAB2 9E08 
OAB4 


OAB4 


2519 
2520 


RET 


2521 END TAPE 


2922 
2523 


2524 GLOBAL NULLTP PROCEDURE 


2525 


2526 | JHBHHBHAHHBEHBBOHBBHEHEHB HEHEHE HEHEEBBHBBHHAE | 


2027 ! 
2528 ! NULLTP PUNCH 50 NULL CHARACTER FOR TAPE LEADER. 


2529 


2530 ! 


! 
! 
! 
JOHHBBHHHBHBHHBEBEHHHEBHE HEB BEE EBEEE EE BEBBBE [ 


2531 ENTRY 


2032 
2933 


LDB RL, #50 
CLR RO 


2534 LRS: = CALR. SCT YWR 


2035 
2936 


DBJNZ = RLiy LRS 
RET 


2537 END NULLTP 


2558 | 


253? 


PAGE EJECT ! 


2540 GLOBAL LODCHD PROCEDURE 


2041 


2542 ! 


2543 
2944 
2545 
2546 
2047 


2048 ! 
2549 ! 
2990 ! 
2001 ! 
2092 ! 


2003 


2594 ! 
2500 ! 
2996 | 
2097 ! 
2598 ! 
2559 ! 
2560 ! 
2061 ! 
2962 ! 
2563 ! 
2564 ! 
2065 ! 


2966 


\ 
| 
| 
1 
\ 
\ 
I 
! 
I 
1 
I 
I 
1 
I 
1 
1 
1 
! 
1 
! 
! 
! 
1 
i 


4000000000000 00 aE 
I 
LOAD COMMAND EXPECT RECORDS OF DATA (ASCII CHARACTER) ! 
IN THE FOLLOWING FORMAT: 
(ADDRESS (4) > (COUNT (2)) (CKSUML (2) )<DATA(2)) cnc 
(DATA(2)) ... (DATA(2)) (CKSUM2 (2) ) 
THE THO CHECKSUM VALUES ARE VERIFIED BEFORE DATA ARE ! 
STORED IN MEMORY SPECIFIED BY THE (ADDRESS). ! 
(CKSUML) IS THE CHECKSUM FOR THE <ADDRESS) & <COUNT).! 
{CKSUM2) IG THE CHECKSUM FOR THE DATA PORTION OF THE ! 
RECORD, ! 
IF THE RECORD RECEIVED WITH COUNT=0, INDICATES THE 
END OF THE LOAD DATA. 
AFTER RECEIVING EACH RECORD, EITHER AN ACKNOWLEDGE 
(ASCII 0 FOLLOWED BY CR) OR NON-ACKNOWLEDGE (ASCII 7 ! 
FOLLOWED BY CR WILL BE SENT. 


IF RECORD RECEIVED IS BEGIN WITH //, SEND THE CHAR 
STRING AFTER // TO TERMINAL» AND ABORT THE COMMAND. 


SYNTAX: LOAD <FILENAHME) 


JHHHHHB HBB HB HHH EHHEEHBHBHBHB HEB HHEBHEHEBHEBEEE | 


2567 ENTRY 


2568 
2969 
2570 


! RESET MCZ INPUT BUF POINTER, INSURE FILENAME EXIST! 


525 


526 


OAB4 DF71 


OABS 6504 
OABA DEDI 
OABC 9£06 


OABE DF6? 
OACO 2102 
OAC4 2028 
OACS OA08 
OACA EEOB 


OACC 2101 
OADO 2103 
OAD4 BB21 
OAD8 4005 
OADC 4150 
OADE 5E08 


OAE2 6705 
OAE6 EE22 


OAEB DF64 


OAEA EF02 


OAEC DFOF 
OAEE E8E7 


OAFO 8034 
OAF2 EE12 
OAF4 DFOF 


OAFS 5400 
OAFA 5000 
OAFE 2100 
B02 2101 
B06 2102 
OBOA BBOL 
OBOE 4005 
OB12 4140 
OB14 BOBO 


2571 
2572 


CALR = CKFNAM 


2973 ! SEND COHHAND TO MCZ/ZDS TO START THE 280 aia ! 


2974 ! 
2579 

2576 

2977 

2978 

2579 

2980 NXXTR: 
2081 

2982 

2583 

2584 

2985 

2586 

2587 

2588 

2589 

2590 


2091 
2992 
2593 RECOK: 
2994 
2595 
2596 
2597 
2098 
2999 
2400 
2601 
2602 
2603 
2604 


AND CHECK IF PROGRAM GET LOADED. 


SET CFLAGS, #LODMDE ! SET BIT FOR LOAD COMMAND! 
CALR — SNDCHD 
RET Z ! PROGRAM DIDNOT GET LOADED! 


CALR —_ LODREC ! FETCH RECORD INTO CONIBF ! 
LD R2y #CONIBF 

LDB RLO» @R2 ! CHECK IS ERROR RECORD ! 
CPB RLO, #7? 

AR NZ, RECOK =! NO! 


LD Ri» #CONOBF 

LD R3y #220 ' MAX 40 CHAR MESSAGE ! 
LDIR = @R1y @R2) RF ! PRINT ERROR MESSAGE ! 
LB QUTPTR» ECONOBF +420 


JP PUTNCR ! & ABORT LOAD ! 
BIT CFLAGS» #ESCAPE ! CHECK IF ESCAPE KEY HIT ! 
JR NZ LABORT ! YES, ABORT ! 

REKCKS ! VERIFY THO CHECKSUNS & =! 


1 RETURN COUNT IN RH3 ! 
JR NC/LODOK ! GOOD CHECKSUM ! 


CALR = BADCKS. ! BAD CKSUM, SEND NON-ACK ! 
JR NXXTR ! TRY AGAIN ! 


2609 ! CHECK IF THIS IS THE LAST RECORD (COUNT=0) ! 


2606 } 
2607 
2608 LODOK: 
2609 
2610 
2611 
2612 
2613 
2614 
2615 
2616 
2617 
2618 
2619 


2620 


PRINT ENTRY POINT OF PROGRAM JUST LOADED FROM MCZ ! 


RH3 ! CHECK COUNT IN RECORD ! 
NZrSTRED ! NOT OsSTORE BATA IN MEHORY ! 
GODCKS ! SEND ACKNOWLEDGE ! 


RRO,CONIBF | MOVE 4 ASCII CHAR FOR ! 
CONOBF+Z0C,RRO ! ENTRY POINT ! 

RO» FENTR 

RL-ACONOBF =! HOVE 7ENTRY POINT’ TO ! 
R286 

@R1 BRO R2 

QUTPTR» #CONOBF +210 


PUTPTR 


OB1é 9E08 2621 RET ! PRINT ’ENTRY POINT XXXX? ! 
2622 
2623 STRED: 
0818 DF2C 2624 RECADR ! VERIFY STARTING ADDR IN ! 
OBiA 0BO1 2625 R1$USERAM =! RECORD GREATER THAN 4440! 
OBIE EDO3 2626 PL»SAVDAT 
B29 2102 2627 R2,8ADBMSG ==! ABORT+PRINT ’HRONG ADDR? ! 
0824 E805 2628 SSG 
2629 
2630 SAVDAT: 
0B26 DF28 2631 CALR —- GODCKS ! SEND ACKNOWLEDGE ! 
B28 DF3D 2632 CALR —-STREC ! STORE DATA IN MEMORY ! 
OB2A EBLY 2633 JR NXXTR ! DONE, GET NEXT RECORD =! 
2634 
OB2C 2102 2635 LABORT: LD R2,#ESCHSG 
0830 DL3F 2636 SHSG! CALR © PUTHSG ! USER WANT TO ABORT ! 
B32 DF30 2637 CALR = ABKCKS ! SEND 79’ TO HCZ ! 
2638 1 AND RETURN TO BEBUG ! 
B34 9E08 2639 RET 
2640 
0B36 2641 END LODCHD 
2642 | PAGE EJECT ! 


2643 
OB36 2644 GLOBAL SEND PROCEDURE 
2645 


527 


2646 
2647 
2648 
2649 
2650 
2651 
2692 
2653 
2654 
2655 
2656 
2657 
2658 
2657 


1) HHH GBH BERS 1 
! 
| 
! 
! 
! 
! 
! 
| 
| 
! 
| 
! 
| 
2660 ! 
! 
| 
! 
| 
| 
| 
| 
! 
! 
! 
! 
! 
! 
! 


i 
SEND TRANSFER DATA IN MEMORY TO HCZ/ZDS SYSTEM. 
ALL DATA ARE CONVERTED TO ASCII CHARACTER BEFORE =! 
THEY ARE SEND, IT SEND MAXIMUM 30 BYTES OF DATA IN | 
ONE RECORD IN THE FOLLOWING FORMAT: 
| 
/CADDRESS) (COUNT) <CKSUML) (DATA) <DATA)...<DATA) | 
(CKSUN2) CR 
WHERE <ADDRESS) - THE ADDRESS OF FIRST BYTE OF DATA ! 
(COUNT) - # BYTE OF DATA IN THAT RECORD 
(CKSUML) - CKSUM OF (ADDRESS) & «COUNT? 
(DATA) ~ DATA BYTE OF SPECIFIED HEMORY 
(CKSUM2) - CHECKSUM OF THE DATA BYTES | 
2661 | 
2662 
2663 ! 
2664 
2665 
2666 
2667 
2668 
2669 
2670 
2671 
2672 
2673 
2674 
2675 
2676 ENTRY 
2677 
2678 | ‘RESET MCZ INPUT BUFFER POINTER/INSURE FILENAME EXIST! 


AFTER SENDING ALL DATA, A RECORD IN THE FOLLOWING 
FORMAT WILL BE SEND AT THE END: ! 


/{ENTRY ADDRESS) 00 <CKSUM) CR ! 
WHERE CKSUH - CKSUM OF ENTRY ADDRESS 


1 
l 
| 
! 
SEND COMMAND WILL RETRY 10 TIMES IF NON-ACKNOWLEGE IS ! 
RECEIVED. THEN IT WILL SEND //ERROR MESSAGE CR | 
TO ABORT COMMAND ! 
| 

I 

I 


SYNTAX? SEND (FILENAME) (BEGINNING ADDRESS){ENDING — ! 
ADDRESS) CCENTRY ADDRESS) 


JHHBEB BB EHEHEHHHBBBHBBHBBH HBB BBEHHBHHBE EBB HEEBHBHEHEEE 


B36 DFB2 CALR = CKFNAM 


OB38 Di30 ? CALR = LOD2 ! GET NEXT 2 ARGUMENT IN ! 
1 R4y RB | 
OB3A E705 JR Cy SENDER =! ERROR» SEND MESSAGE ! 


OB3C A148 LD RBr R4 ! SAVE STARTING ADDRESS 
OBE A137 LD R7r R3 ! SAVE ENDING ADDR ! 


B40 D210 CALR —-GETADN ! CHECK IF ANY ENTRY ADDR ! 
B42 A136 LD Rér R3 ! IF NO ENTRY ADDR» DEFAULT! 
! 10 ZERO ! 


B44 8387 26 SUB R71 RB ! FIGURE # OF BYTES ! 

0B46 SEO7 O14E 2694 SENDER: JP Cy EROR ! ERROR IN ADDRESSES ! 

OB4A A970 2695 INC R7 1 SEND BEG.ADDR TO END ADDR! 
2696 1 INCLUSIVE | 

OB4C 6503 4304 © 2697 SET CFLAGS #SNDMDE ! SET BIT IN SEND PROCESS! 


528 


OBS0 DFIC 
OBS2 9E06 


0854 DF36 
OBS4 E603 
B58 2102 
OBSC E831 


OBSE 6705 
OB62 £605 


OB64 DEB4 
0866 2102 
OB6A DISC 
OB6C 9E08 


OBSE 4005 
0B74 0B07 


B78 EFO3 
OB7A A179 
OB7C 8078 


OB7E E804 
OB80 2109 
OBB4 0307 


OBB8 ALPE 


OBBA 6705 
OBBE EEEA 


OB90 2102 
OB94 DFIS 
B96 E60B 


2698 
2699 
2700 
2701 
2702 
2703 
2704 
2705 
2706 
2707 
2708 
2709 
2710 
27il 


! SEND COMMAND TO MCZ/ZDS TO START THE Z80 PROGRAM 
! AND CHECK IF PROGRAM GET LOADED. 


CALR  SNDCMD 
RET Z ! PROGRAM DIDNOT GET LOADED! 


! WAIT FOR ACKNOWLEDGE, ALSO CHECK IF ESCAPE HIT ! 


WATACK ! WAIT FOR ACKNOWLEDGE FIRST! 
Z,/0P0K ! FILE OPEN OK ! 

R2,80PNMSG =| GOT '7’ OR ’9! FROH HCZ FOR! 
PUTH ! UNABLE TO OPEN FILE ! 


2712 OPOK: 


2713 
2714 


CFLAGS, #ESCAPE 
ZsNXTR 


2715 SABTS: 


2716 
2717 
2718 
2719 
2720 
2721 
2722 
2723 


SNDERR ! SEND ERROR RECORD TO HCZ ! 
R2,#ESCHSG =! ABORT! TO TERMINAL ! 
PUTMSG 


! DETERMINE THE VALUE FOR (COUNT) IN THE NEXT RECORD! 
! RB = STARTING ADDRESS, R7 = # OF BYTES ! 


2724 NXTRt 


2725 
2726 
2727 
2728 
2729 
2730 
2731 
2732 


RETRY, #10 =! HAX TRY 10 TIMES ! 

R7> #30 ! IF REMAINING BYTE{30, USE! 
! (COUNT)=REMAINING BYTE! 

NC SET30 

RY» R7 | COUNT=REMAINING BYTE, 

R7 ! R7=0 INDICATE LAST! 
! DATA RECORD ! 

COTT 


2733 SET30: RP, #30 ! SEND 30 BYTE FOR NOW ! 


2734 
2735 


2736 COTT: 


2737 
2738 
2739 
2740 
2741 


R71 #30 ! FIGURE REMAINING BYTE FOR! 
1 NEXT TIME ! 

Rily RY ! SAVE (COUNT) INCASE NEED ! 

TO SEND THE SAME RECORD! 


! FORMAT ADDRESS, CHECKSUM & DATA IN RECORD & ! 
! SEND TO MCZ ONLY IF ESCAPE NOT PRESS ! 


2742 RESEND: BIT CFLAGS» #ESCAPE 


2743 
2744 
2745 
2746 
2747 
2748 


JR NZ, SABTS =! SEND ERROR RECORD 10 HCZ ! 
! & MESSAGE TO USER/ABORT ! 


LD 2$MCZPTR =| SEND DATA RECORD TO CZ ! 
CALR —RECSND 
JR Zr LREC ! SEND LAST RECORD ! 
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B98 DF13 SKPLNE ! SKIP INPUT LINE FROM HCZ! 
! WHICH ECHO THE DAT RECORD! 


OB9A DFS? HATACK 
OBC EEOL NZ, RECE79 =! EITHER RECEIVE 77! OR '9!! 
OBIE EBE7 NXTR ' Z MEANS ECEIVE ’0? ! 


736 
OBAO E700 2757 RECE79: JR CrABTS 'NZ»C RECEIVE ’97 ! 
2758 
2759 
2760 ! RECEIVE NON-ACKNOWLEDGE, RESEND SAME RECORD ! 
2761 
OBA2 8388 2762 R8, Ril ! RECEIVED NON-ACK ! 
OBA4 ALB? 2763 RP Ril ! BACK UP ADDR»RESTORE CNT! 
OBAé 6B00 43FA = 2764 RETRY 
OBAA E6OF 2765 Z SNDABT ! STOP TRYING ! 
2766 
OBAC EBEE 2767 JR RESEND 
2768 
2769 ! SEND LAST RECORD /{ENTRY ADDR) 00 <CKSUM) CR ! 
2770 
OBAE 2102 2771 LREC: = LD R2,$HCZPTR =! SEND LAST RECORD TO ! 
OBB2 DF89 2772 CALR —LASREC !  WCZ/ZDS SYSTEM ! 
OBB4 DF21 2773 CALR — SKPLNE ! SKIP INPUT LINE FROM MCZ! 
2774 ! WHICH ECHO DATA RECORD! 
2775 
2776 
OBB DF47 2777 CALR WATACK ! WAIT FOR ACKNOWLEDGE ! 
OBBS 9E06 2778 REF) 2 ! DONE... ! 
2779 
OBBA EFO4 2780 (2: AR NC» RESD ! NZNC RECEIVE 7, RESEND ! 
OBBE 2102 2781 ABTS: LD R2r#FLEMSG ==! RECEIVE 9’ sFILE ERROR ! 
OBCO D187 2782 PUTH: = CALR PUTHSG 
OBC2 9E08 2783 RET 
2784 
2785 
2786 ! GOT ’7’, SEND SAME DATA IF THIS IS NOT THE 10 TIMES ! 
2787 
OBC4 6800 2788 RESD: DEC RETRY 
OBCE EEEO 2789 JR NZ» RESEND 
2790 
2791 SNDABT: 
OBCA DEE7 2792 CALR  SNDERR ! ENOUGH, STOP TRYING, SEND ! 
OBCT 2102 2793 LD R2,#ABHSG ! 7CKSUM ERROR? TO TERMINAL! 
OBDO D18F 2794 CALR = PUTHSG 
OBD2 9E08 2795 RET 
OBD4 2796 END SEND 
2797 | PAGE EJECT! 
2798 
OBD4 2799 GLOBAL CKFNAH PROCEDURE 
2800 
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OBD4 4008 
OBDS 4008 
OBDC D248 
OBDE OA08 
OBE2 £703 
OBE4 OA08 
OBEB 9E07 
OBEA SE08 
OBEE 


OBEE 


OBEE DF2A 
OBFO OAOB 2F2F 
OBF4 EEFC 


OBFS 2104 4080 
OBFA CBSO 


2801 | JHBBHHB EDO BEBE EHEBHHB BEBE HBBHIHOB EEE HERE E i 
2802 ! 
2803 ! CKFNAH RESET THO POINTERS OF MCZ INPUT BUFFER BEFORE | 
2804 ! STARTING THE UPLOAD/DOKNLOAD PROCESS. ALSO CHECK | 
2805 ! THE FILENAME 1S INCLUDED IN THE COMMAND. I 
2804 ! | 
2807 ! 
2808 

2809 ENTRY 

2810 CLR -HCZPUT 

2811 CLR -MCZGET =! - RESET MCZ INPUT BUF POINTER! 
2812 CALR -NXTARG «=! SKIP OVER COMMAND ! 

2813 CPB RLOy 4A’! INSURE FILENAME EXIST ! 

2814 JR Cy HRNAHE 

215 CPB RLO, #7244 

2816 RET oC | FILENAME OK ! 

2817 WRNAME: JP EROR | COMMAND SYNTAX ! 

2818 END CKFNAM 

2819 

2820 

2821 GLOBAL LODREC PROCEDURE 

2822 


JEBBBBBEE BHR HE HBHEHEHB BEEBE HEEEEEHEE HEHEHE 


2823 | JHHAHHABHHHEHHHHEHHHBHBHHHHBEB HEBER HEHHEBEBHHE | 
2824 
2825 
2826 
2827 


| 
! LODREC READ IN AN INPUT LINE INTO CONIBF FROM HCZ 
! START STOREING DATA IN CONIBF WHEN RECEIVE A '/?, 
! THE INPUT LINE IS TERMINATED BY CARRIAGE RETURN. 
2823 ! IT WILL READ IN MAXIMUM 80 ASCII CHARACTERS 
2829 ! AND IGNORE THE REST UNTIL A CARRIAGE RETURN 1S 
2830 ! RECEIVED, SKIF OVER ANY CONTROL CHARACTER ( {20H ) 
2831 ! 
2832 | 
2833 | 
2834 | 
2835 | 
2836 | 
2837 ! 
2838 
2839 ENTRY 
2840 ! WAIT FOR A ’/’ TO BEGIN STORING CHARACTER INTO ! 
2841 ! CONIBF. CONIBF DOES NOT INCLUDE '/’, ! 
2842 
2843 CALR —-MCZINP 
2844 CPB RLO, #7! ! WAIT UNTIL ?/! ! 
2845 JR NZ» LODREC 
2846 
2847 LD R4y #CONIBF 
2848 LDB RL3, #80 ! MAX GET 80 CHARACTER! 
2849 
2850 
2851 ! START STORING CHARACTER, IGNORE CONTROL CHAR ! 
2852 ! ALSO CHECK FOR CARRIAGE RETURN FOR END OF RECORD ! 


QUTPUT: = RETURN DATA IN CONIBF 
HHH ROe R2r RL» RA RS ARE LOST sv 


JOBE DOB EEE HHBBBBEEHBHHBHUBE BE BB HHBEHBHHHBBHBHBBBEBHEE 1 


531 


2893 
OBFC DF3i 2854 LODRCO: CALR = HCZINP 
2899 
OBFE 2648 2856 @R4r RLO ! STORE CHAR ! 
OC00 OAOB 2857 RLO» @ASCICR | CHECK FOR END OF RECORD ! 
0004 EEO2 2858 NZ, CKCT 
0006 DF46 2859 SKPNUL ! SKIP THE REST OF LINE ! 
OCO8 YE08 2860 
2861 
2862 CKCT: 
OCOA 0A08 RLO, #” ? ! IGNORE CONTROL CHAR! 
OCOE E7F6 Cy LODRCO 
OC10 A940 R4y #1 ! GOOD CHARACTER ! 
OC12 FBOC RL3, LODRCO | DECREHENT CHAR COUNT ! 


284? 1 ALREADY RECEIVE 80 CHARACTERS, SKIP OVER ALL ! 
2870 1 CHARACTERS UNTIL CARRIAGE RETURN. | 
2871 
OC14 DF3D 2872 LODRC2: CALR —-MCZINP 1 GOT 80 CHAR, IGNORE THE! 
2873 
OC16 OA08 2874 CPB RLO, #ASCICR ! REST OF CHAR EXCEPT CR ! 
OCIA EEFC 2875 JR NZ» LODRC2 
2876 
OCiC 6E08 2877 LDB CONIBF+80,RLO ! GOT CR ! 
0C20 9608 2878 RET ! WILL RETURN Z FOR OK ! 
2879 
2880 
0022 2881 END LODREC 
2882 
2883 
0022 2884 GLOBAL REKCKS PROCEDURE 
2885 
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2886 | JHH}HHBHBHHHHHBHBRHBBBBGHBHHHBHBHBHHEHEBHHABHBEBHHBEE | 

2887 ! ! 

2888 ! REKCKS VERIFY THO CHECKSUM VALUES IN A RECORD STORED 
IN CONIBF. ALL ASCII CHARACTERS IN CONIBF ARE ! 
CONVERTED 10 4-BIT HEX VALUE TO OBTAIN CHECKSUH mu 
IS THE SUM OF ALL THESE 4 BIT HEX VALUE. 


THE FORMAT OF THE RECORD IS AS FOLLOWED: 
(ADDRESS (4)) {COUNT(2)) (CKSUM(2)) <DATA(2)> 
(DATA(2)) ... (DATA(2)) (CKSUH(2)) (CR) 


INPUT: RECORD IN CONIBF 


RETURN C IF CHECKSUM IS BAD 
RETURN C IF NON-ASCIZ CHAR FOUND IN CONIBF 
RETURN NC IF OK 


| wwe ROr R2, RI ARE DESTROYED wx 


1 
! 
| 
| 
| 
l 
! 
QUTPUT: RH3 = (COUNT) IN BYTE VALUE ! 
| 
I 
1 
| 
! 
I 
| 
I 


| GHBBHBBEHHBBHHBEBEHBOBHDEBHEEE BH ABBBAHBHHOHEBHEE EEE | 


2909 ENTRY 
OC22 2102 40B0 2910 LD R2> #CONIBF 
0026 C303 2911 LDB RH3, #3 ! 6 CHARACTERS TO CHECKSUM! 
0C28 DFFY 2712 CALR = CHKCKS ! VERIFY 1ST CHECKSUH ! 
OC2A 9E07 2913 RET C ! RET IF BAD ! 
2914 
OC2C 8034 2915 TESTB = RH3 ! CHKCKS RETURN RHS=COUNT ! 
OC2E 9E06 2916 RET v4 1 IF COUNT=0, NO DATA ! 
2917 ! RET NC IF OK ! 
0030 93F3 2918 PUSH = @R1Gy RI ! SAVE COUNT FOR LATER ! 
0032 DFFE 2719 CALR = CHKCKS ! VERIFY BATA CKSUN ! 
2920 ! # OF CHAR = (RH3)#2 ! 
2921 
0034 97F3 2922 POP R3, RIS ' RETREIVE COUNT IN RH3! 
0036 9E08 2923 RET 
2924 
0038 2929 END REKCKS 
2926 
2927 
0038 2928 GLOBAL CHKCKS PROCEDURE 
2929 


IS3 
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OC38 BCBB 
OCSA DFFS 


OC3C 9E07 
OC3E F303 


0040 A083 
0042 93F3 


0C44 DFFA 


0046 97F3 
0048 9£07 


OC4A BABB 


2930 
2931 
2932 
2933 
2934 
2935 
2936 
2937 
2938 
2939 
2740 
2941 
2742 
2943 
2944 
2949 
2946 
2947 
2948 
2949 
2900 
2951 
2952 
2953 
2994 
2959 


JHBHHEHBEHHBBHEHHER HEHEHE EE HEEUHHEEHHEHEUHHEBHEBE | 


CHKCKS VERIFY CHECKSUM IN THE RECORD. CONVERT ASCII 
CHARACTER IN THE RECORD TQ HEX VALUE AND ACCUNLATE 
THEIR SUM TO OBTAIN THEIR CKSUH. THEN COMPARE THE 
CALCULATED CHSUM AGAINST THE CKSUM IN THE RECORD 
RHICH IS FOLLOWED THE CHARACTER STRING. THE CKSUH 
IN THE RECORD IS ALSO ASCII CHARACTER, NEED TO 
CONVERT TO HEX VALUE . 


\ 
! 

! 

! 

! 

! 

! 

! 

I 
INPUT: R2 = POINTER TO THE ASCII CHAR STRING | 
RH3 = # OF PAIR OF CHARACTERS TO CHECKSUM =! 

( TOTAL CHAR = RH3*2 ) ! 

1 

QUTPUT: RH3 = COUNT VALUE IN THE RECORD (HEX) ! 
! 

| 

| 

! 

! 

| 

! 

! 

| 

! 


RL = CALCULATED CHECKSUM (HEX) 
RLO = CHECKSUM IN THE RECORD (HEX) 


RETURN C IF CKSUM BAD 
RETURN C IF FOUND NON-ASCII CHARACTER 
RETURN NC IF CKSUH IS CORRECT 

#4 RO» R2e RI ARE DESTROY sitex 


JEHBBBEHBHBBHGHHE HHH BBB EBT BEE HEHEHE 


2956 ENTRY 


2957 
2998 
2999 
2960 
2961 
2962 


2963 CHKSM2: CALR = LODBYL 


2964 
2965 
2966 
2967 
2968 
2969 
2970 
2971 
2972 
2973 
2974 
2975 
2976 
2977 
2978 
2979 
2980 
2981 


! INITIALIZE CKSUM ACCUMULATOR (RL3), CONVERT ! 

1 THE NEXT # OF PAIR OF CHARACTERS TO HEX VALUE ! 
1 AND SUM UP THEIR HEX VAULE. THE HEX VALUE OF ! 
! LAST PAIR OF CHARACTERS RETURN IN RLO ! 


CLRB RLS ! INIT CKSUM ACCUMULATOR ! 
! CONVERT NEXT 2 CHAR TO ! 
! HEX&ADD TO CKSUM ACCUM, ! 
RET C ! FOUND NON-ASCIT CHAR ! 
DBUNZ RH3» CHKSM2 ! NEXT PAIR OF CHAR ! 


! SAVE B-BIT HEX VALUE OF LAST THO CHARACTERS ! 

1 (COUNT GF THE DATA IN THE RECORD) SAVE CALCULATED! 
! CKSUM THEN CONVERT NEXT THO CHAR TO OBTAIN CKSUM ! 
! IN RECORD AND COMPARE THE THO CKSUM ! 


LDB RH3, RLO ! RH3=COUNT VALUE & ! 
PUSH = RAG RB ! RLS=CALCULATED CKSUN ! 
CALR = LODBYL ! CONVERT NEXT THO CHAR TO! 
! GET RECORD CKSUM IN RLO! 
POF R3, @RIS ! RETREIVE CALCULATED CKSUH! 
RET C ! BAD CHARACTER ! 


CPB RLOr RLI ! COMPARE THO CKSUN ! 


OC4C 9E06 
OC4E 8D81 
050 9E08 


0052 


0092 


OC92 DFFS 


0C54 9607 
0C56 B08B 
C58 8309 000 
OCSC DFFB 
OCSE 9£07 
C60 808B 
0062 8408 
C64 8083 
0066 £08 


0068 


C68 


2982 RET z 
2983 SETFLG C 
2984 RET 


2985 
2986 END CHKCKS 


2988 
2989 GLOBAL LODBYL PROCEDURE 
2990 


2991 | HBHBHBBHHHEDEB HB OH EBBHEO BABB HEE HBB BEBEBEBHHBBEBEHEE 1 


2972 | 


2993 | CONVERT THO ASCII CHARACTERS TO THO 4-BITS HEX VALUE ! 


2994 | AND ADD THE TWO HEX VALUES TO AN ACCUMULATOR 
2995! 
INPUT: R2 = POINTER TO THE FIRST ASCII CHARACTER 
RL3 = ACCUMULATOR 


1 QUIPUT: R2 = UPDATED POINTER ( INC BY 2 ) 
RL3 = UPDATED ACCUMULATOR 


RLO = 8 BITS HEX VAULE OF THE THO ASCII CHAR ! 


RETURN C IF ANY CHARACTERS ARE NON-ASCII 
RETURN NC IF OK 


1 eee RO IS DESTROYED see 


2008 | JHHBHBHAEHEHAHBEHEBBHEHEHHEHHABHBEHHHHEHHEHBHBBHEBHEEE | 


3009 

3010 ENTRY 

3011 HEXDCD ! CONVERT CHAR POINTED BY ! 
3012 ! R2 TO HEX IN RLO ! 

3013 C ! BAD CHARACTER ! 

3014 RL3 RLO ! ADD HEX VALUE TO ACCUM. ! 
3015 RO» #12 ! SAVE HEX IN RHO BIT 4-7 ! 
3016 HEXDED ! CONVERT NEXT CHAR ! 

3017 C 

3018 RL3y RLO ! ADD HEX TO ACCUMULATOR ! 
5019 RLO, RHO ! MERGE THO HEX VAULE ! 
3020 RESFLG C 

3021 RET ! RETURN NC FOR OK ! 

3022 

3023 END LODBYL 


3025 
3026 GLOBAL HEXDCD PROCEDURE 
3027 
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3028 | ]HBHHB}HEHBBHHEEHBBHBEBBBHBHHEHHEBH HEB HEB ERE HEEEBHABE | 
3029 ! ! 
3030 ! CONVERT ASCII CHARACTER POINTED BY R2 TO CORRESPONDING! 
$031! 4-BIT HEX VAULE. INCREMENT POINTER R2 BY 1 ! 
3032 ! ! 
3033 |! INPUT: 2 = POINTER TO ASCII CHAR | 
3034 ! ! 
3035 ! QUTPUT: R2 = ADVANCE BY 1 & POINTED TO NEXT CHAR =! 
5036 ! RLO = 4-BIT HEX VALUE OF ASCII CHAR ! 
3037 | | 
3038 ! RETURN C IF CHAR IS NON-ASCII ! 
5037 | RETURN NC IF OK | 
3040 ! | 
3041 | JeHHHHRD HABA OHHHHEHGBEHBHOHBBHEEHEBBAHBEEBHBBRBHHE | 

3042 

3043 ENTRY 
C68 2028 3044 LDB RLO» @R2 ! GET ASCIY CHAR ! 
OC6A A920 3045 INC RQ #1 ! ADVANCE POINTER ! 
OCC SEOQB O4FA’ 3044 JP CONVERT ! EITHER RET C OR NC ! 

3047 
0070 3048 END HEXDCD 

3049 

3050 

3051 

3052 GLOBAL RECSND PROCEDURE 

3053 


S054 | eH HHEHEHEHHBEB HEIR HBHEEB EHH ESHER EEBHBHBHBBE 1 
3055 ! 
3056 ! RECSND FORMAT ADDRESS, COUNT, CHECKSUM & DATA IN 
3057! TEKTRONIX FORMAT. IT EITHER SEND THE DATA TO HCZ/ 
3058 ! ZDS SYSTEM OR TO THE TERMINAL, 
3059 ! IF COUNT = 0 » JUST STORE ’/’ IN BUFFER & DON’T 
3060 ! FORMAT THE DATA, 
5061 ! 
3062 ! INPUT: R9 - COUNT, RB - STARTING ADDRESS 

R2 - ROUTINE ADDRESS (PUTPTR OR HCZPTR 


{ QUTPUT: RB INCREASE BY R9(COUNT) 
RETURN Z FOR LAST RECORD 
RETURN NZ FOR SENDING THE RECORD & READY 
FOR ACKNOWLEDGE 


3070 | eH RO, R2r RIr RS» RP ARE LOST ave 
3071 ! ! 
3072. | HRHEHEHHBEBEHEHBBHEEEHEHHEBBE EEE HHHEBH HEEB BE HEGEAHHE 
073 
3074 ENTRY 

0070 8038 3075 R3 

0072 CB2F 3076 RLO, #77! 

0074 6608 4130 3077 CONOBF, RLO =! STORE */? ! 

OC78 6900 4386 3078 OUTPTR» #1 | ADVANCE CONOBF OUTPUT PTR! 
3079 


| 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
l 
! 
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OC7C BD94 R? ! CK COUNT=0 FOR SENDING! 
OC7E 9E06 Z ! LAST RECORD (ENTRY ADDR)! 


0C80 A185 RSs RB ! ADD ADDRESS(4) TO CKSUM ! 

OCB2 DIA? PUT2 ! (RL3)4-BIT AT A TIME. ! 
! CONVERT EACH 4 BIT VALUE! 
! TO ASCII CHAR AND STORE ! 
! THEM IN CONOBF ! 

OCB4 A195 LD Ros RP ! 

OC86 DLAI CALR © PUTL ! 

OC88 AOBD LDB RLS, RL3 

OCBA DLAB CALR = PUTL ! STORE ADDR &COUNT CKSUMI! 


STORE COUNT(2) IN CONOBF ! 
& UPDATE CKSUM (RL3) ! 


! FORMAT (DATA) ... (DATA) (CKSUM2) ! 


OC8C 8038 CLR ORS ! INIT CKSUM ! 
OCBE 2080 3096 MDATA: LDB RLS, @RB ! ADD DATA TO CKSUM (RL3) ! 
0C90 DLAE 3097 CALR = PUTL ! 4-BIT AT A TIME. CONVERT! 
3098 ! 4-BIT VALUE TO ASCII CHAR! 
3099 ! AND STORE THEM IN CONOBF! 
C92 A980 5100 INC = RB? #1 ! ADVANCE MEMORY ADDRESS ! 
5101 ! DUNZ = R9» MBATA R9=COUNT OF DATA ! 
C94 ABIO 3102 DEC =P 
0C96 EEFB 3103 JR NZ MDATA 
3104 
C98 AOBD 3105 LDB RLS, RLS 1 STORE DATA CKSUH! 
OCPA DIB3 3106 CALR  PUTI 
3107 
3108 ! SEND RECORD 10 MCZ/ZDS SYSTEM ! 
3109 
OCIC 1F20 3110 CALL = @R2 ! CALR PUTPTR / HCZPTR 
S111 
OCPE Bb43 3112 RESFLG Z ! RET NZ FOR NEXT REC ! 
OCA) 7£08 Hig RET 
3114 
OCA2 S115 END RECSND 
3116 
$117 
OcA2 S118 GLOBAL LASREC PROCEDURE 
S11? 
3120 | JHHHBHHHBHHAHHBHHBBB HB HHEHEB IH HEB IER B HB BHEETHEBE 
3121 ! 
3122 | 
3123 ! 
3124 ! 
S125 |! 


| 

! ! 
! LASREC FORMAT ENTRY ADDRESS WITH 0 COUNT» CHECKSUM ! 
! | 
! ! 
! ! 
3126 ! INPUT + Ré - ENTRY ADDRESS ! 
! ! 
! ! 
1 ! 
! | 
! ! 


IN TEKTRONTIX FORMAT FOR THE LAST RECORD 
TT EITHER SEND THE DATA TO TERMINAL OR HCZ/ZDS. 


3127 | R2 - ROUTINE ADDRESS (PUTPTR OR MCZPTR) 
3128 ! 
3129 ! 
3130 ! 
131 ! 


HHH ROD R2r RB RS ARE LOST see 


JOHHBBEBEHBHAHBBIHBHBHHHHBHHB HEHE GHB HBBEBEHHEBHBHEBE 
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332 
3133 ENTRY 
OCA2 A165 Rj RE] RS, R6 
OCA4 DIBA R35 PUT2 
OCAS COO 3136 RLS #0 ! 00 IN CONOBF ! 
OCAS DIBA 3137 PUTL 
OCAA AOBD 3138 RLS» RL ! CKSUM ! 
OCAC DIBC 3139 PUTL 
OCAE 1£28 3140 @R2 ! SEND TO TERMINAL OR HCZ! 
3141 
OBO 3142 END LASREC 
3143 
3144 
OCBO 3145 GLOBAL STREC PROCEDURE 
3146 
SCVMM iiiiiiiiiiittiiiitititiiititiiiiiiititittii ttt ttt) tal 
3148 ! 
3149 ! STREC UNPACKS DATA IN RECORD & STORE THEM IN MENORY 
3150 ! LOCATION WHICH SPECIFIED IN THE RECORD. 
Ht ! 
3152 ! INPUT: RECORD IN CONIBF 
3153 |! RH3 - # OF BYTES OF DATA IN CURRENT RECORD 
3154 ! 
S155 ! wee ROr R1y R2e RI R4 ARE LOST svete 
3156 ! ! 
SRV iiiiiitiititiiititiitiititiist ti tt) tty a 
3158 ENTRY 
3159 
3160 LBB RL4, RH3 ! SAVE COUNT 
3161 
3162 ! CONVERT (ADDRESS) & (DATA) TO HEX VALUE.STORE ! 
3163 ! BYTE DATA IN MEMORY. THE # OF BYTE OF DATA IS ! 
3164 ! SPECIFIED BY (COUNT) ! 
3165 
OCB2 DFF9 3166 CALR —-RECADR ! GET RECORD ADDR IN Ri ! 
OCB4 2102 3167 LD R2, #CONIBF+8 'ADDRESS OF 1ST DATA 
3168 
OCBS D034 31469 LODFR3: CALR = LODBYL ' CONVERT NEXT 2 CHAR 10 
3170 ! BYTE DATA IN RLO 
OCBA 2E18 u71 LDB @Rir RLO ! STORE DATA IN MEMORY 
OCBC A910 3172 INC Ri, #1 1 ADVANCE MEMORY ADDRESS 
OCBE FCO4 3173 DBUNZ = RL4y LODFR3 
OfCO 9EOB 3174 RET 
3175 
ort2 3176 END STREC 
3177 
3178 
oct2 3179 GLOBAL RECADR PROCEDURE 
3180 
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3181 ! JEHEHB HBB HEBHEE EHUB HEHHEB HBB HBEHBEABEBHBHBEE | 
3182 ! | 
3183 ! CONVERT THE STARTING ADDRESS IN LOAD RECORD TO HEX | 
3184 ! VALUE IN Ri | 
3185 | 
3186 ! 
3187 
3188 ENTRY 
OCC2 2102 4080 3189 LD —sR2r SCONIBF | CONVERT NEXT 4 ASCII CHAR! 
OCCS DO3B 3190 CALR —LODBYL | TQ HEX ADDRESS IN Ri! 
OCCE A081 3191 LDB RHA RLO.~—!-1ST BYTE OF AN ADDRESS | 
OCCA DO3D 3192 CALR —LODBYL 
OCCE Ada? 3193 LDB = RL1y RLO.~—!- OND BYTE OF ADDRESS 
OCCE 9£08 3194 RET 
ocDo 3195 END RECADR 
3196 
3197 
3198 GLOBAL GODCKS LABEL 
3199 GLOBAL BADCKS PROCEDURE 
3200 
3201 ! 
3202 ! | 
3203 ! 
3204 ! 
3205 ! 
3206 ! 
3207 ! GODCKS SEND ACKNOWLEDGE (ASCII 0 (30H) & CR) FOR! 
3208 ! RECEIVING A VALID RECORD OF DATA 
i I 
! 
| I 
| 
| 


JEBHOHHEBEBHBDBEBBEBBBUUE BEE HEB BBB BHBHHBHEHUBHEEEE | 


JEHHBHHBHGHEHHBHEEBBEHBHHHBHEHEEHEHBBEHE HEH HHBBHEHEEE | 


BADCKS SEND NON-ACKNOWLEDGE (ASCII 7 (37H) & CR ) FOR 
RECEIVING NON-ASCIT CHARACTER OR CHECKSUM IN THE 


RECORD IS INCORRECT 


3209 
3210 
$211 
3212 
3213 
3214 
3215 
3216 
3217 ENTRY 

OCDO C837 3218 LDB RLO #°7! 

OCD2 £803 F219 JR MSEND 
3220 

OCD4 C83? 3221 ABKCKS: LDB RLO» #79? 

OCDS E801 3222 JR HSEND 
3223 

OCDE C830 3224 GODCKS: LOB RLOIE'O! 

OCDA 6E0B 4130 3225 MSEND: LOB CONOBF +RLO 

OCDE 4005 4386 ©3226 LD QUTPTR» #CONOBF +1 

OCE2 4131 

OCE4 DF9B 3227 CALR = MCZPTR ! QUTPUT CONBOF ! 

OCE6 DFBA 3228 CALR = SKPLNE ! SKIP INPUT LINE FROH CZ! 
$229 ! WHICH ECHO ACKNOWLEDGE! 

OCEB 9E08 3230 RET 
3231 


ABKCKS SEND ABORT-ACKNOWLEDGE (ASCII 9) FOR USER 
HANT TO ABORT THE DOWNLOAD PROCESS. 


#6 ROr Rly R215 DESTROYED tee 
| 


JEHHHB THE HEHE B BEBE HHBEHHEEIHE HEHE HBEHEEHEEEEE 
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3232 END BADCKS 
3233 


3234 
3235 GLOBAL HATACK PROCEDURE 
3236 


5237 
3238 
3239 
3240 
$241 
3242 


1) J} 0H HBB BIG BEEBE: | 
! 
! 
! 
! 
| 
3243 | RETURN Z, NC RECEIVE GOOD-ACK FROM HCZ 
! 
! 
1 
| 
i 
| 


! 
EXPECT EITHER ACKNOWLEDGE (ASCII 0) OR NON-ACKNOWLEDGE! 
(ASCIT 7) FROM SERIAL LINE. | 
IGNORE OTHER CHARACTERS 


| 
1 
! 

3244 RETURN NZ»NC RECEIVE NON-ACK FROM MCZ | 
3245 RETURN NZ»C RECEIVE ABORT-ACK FROM HCZ ! 
3246 ! 
3247 1 
3248 | 
3249 ! 
3250 
3251 ENTRY 

OCEA DF7F 3252 CALR — MCHAR ! GET CHAR ! 

OCEC 0A? 3253 CPB ORLdy #70’ =! CHECK FOR ACKNOWLEDGE! 

OCFO EE04 3254 JR NZ» CK79 ! NO » CHECK FOR 7 OR 9 ! 

OCF2 DFCO 3255 CALR — SKPLNE ! YES, SKIP THE LINE ! 

OCF4 841 3254 SETFLG Z 

OCFS 883 3257 RESFLG C 

OCFB 9E0B 3258 RET ! RETURN Z»NC FOR GOOD-ACK ! 
3259 

OLFA OA0? 3260 CK79: CPB RL, #7’ =! CHECK FOR NON-ACK, ! 

OCFE £E04 3261 UR NZr CK9 1 NO! 

OD00 DFC? 3262 CALR — SKPLNE 1 SKIP RESPONSE LINE ! 

0002 8543 3263 RESFLG 2 

0D04 8b83 3264 RESFLG C 

OD04 9E08 3265 1 RETURN NZsNC FOR NON-ACK ! 
3266 

0008 0A0? 3267 CK9: RLir #9! 

ODOC £602 3268 Zr HATC 1 YES» ABORT-ACK ! 

ODOE DFBA 3269 MCZINP ! ADVANCE POINTER 10 GET! 
3270 | NEXT CHAR ! 

O10 EBEC 3271 WATACK 

OD12 DFDO 3272 WATC: CALR —SKPLNE ! SKIP OVER RESPONSE LINE! 

OD14 843 3273 RESFLG 2 

OD16 8081 3274 SETFLG C 

OD18 9E08 3275 RET ! RETURN NZ*C FOR ABORT-ACK! 

ODIA 3276 END WATACK 
3277 
3278 
3279 
3280 GLOBAL SNDCHD PROCEDURE 
3281 


we RO TS DESTROYED sae 


HBB HHH EHH BBE EBB EHBHEEEE HEHE EERE HEHEHE 
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3282 ! JOB HBHEHSUHBEBI BIB HB HEHE HEHEHE HHEEHEEEEEE I 


5283 ! 
3284 
3285 
3286 
3287 
3288 
5289 
3290 
3291 


SNDCMD SEND THE RIO COMMAND ’B;? FOLLOWED BY THE 
COMMAND RECEIVED FROM THE TERMINAL TO THE HCZ. 
THE ’Bi? FORCE MCZ TO BE IN BRIEF MODE. ! 
THEN SKIP OVER THE INPUT LINE RECIEVED FROM MCZ THAT! 
ECHO BACK THE COMMAND JUST SEND. IT THE HCZ IS IN ! - 
VERBOSE MODE, SKIP OVER TWO LINES. THEN CHECK THE ! 
FIRST CHARACTER IN THE FOLLOWING INPUT LINE RECEIVED! 
FROM HCZ. IF THE CHARACTER IS NOT AN VALID ! 


3293 
3294 
3295 
32% 
3297 
3298 
3299 
3300 
3301 ENTRY 

ODLA 6705 3302 BIT CFLAGS #ESCAPE 

ODLE £602 3303 JR Z, NOESC 

0020 8D41 3304 SETFLG Z 

0022 9€08 3305 RET ! RETURN Z FOR PROGRAM DID! 
3306 ! NOT LOADED ! 
3307 NOESC: 

0024 2101 Rly #44238 ! SEND ’Bs’ TO RIO TO FORCE! 

0028 6FOL CONOBF Ri ! IN BRIEF MODE ! 


INPUT LINE TQ THE TERMINAL» THIS MEANS THE 280 
PROGRAM DID NOT GET LOADED, 


RETURN Z IF HCZ DID NOT LOAD THE Z80 PROGRAM 


! 
! 
! 
! 
! 
! 
! 
! 
3292 ! ACKNOWLEDGE ( ASCII 0» 91 7 )» THEN PRINT THE 
I 
1 
{ 
! 
I 
I 
! 


! 
! 
! 
! 
QUTPUT: RETURN NZ IF HCZ GET Z80 PROGRAM LOADED. ! 
| 
! 
I 


29-9 0 9 9 0 3 8 0 9 A 9 0 0 0 i 


Ob2C 2100 RO» #CONOBF+2 

OD30 2101 Rl» #CONIBF ! TRANSFER COMMAND TO ! 
0D34 2102 R2, $440 1 — CONOBF BUFFER ! 
OD38 BBit @ROGRIR2 

OD3C 4005 QUTPTR» #CONOBF +280 

0040 4180 

OD42 DFC4 MCZNCR ! SEND CONOBF TO HeZ ! 


! SKIP OVER HCZ INPUT LINE THAT ECHO THE COMMAND ! 
OD44 DFE? CALR —-SKPLNE ! SKIP OVER SINGLE LINE ! 


0046 DFAD CALR —-HCHAR | WAIT FOR RESPONSE FROM HCZ! 
! EITHER ECHO ’B? OR RESPONSE! 
1 FROM 280 PRGRAM OR RESPONSE! 
! FROH RIO ! 


OD48 0A09 RLi, #’B’ | IF MCZ IN VERBOSE MODE, IT ! 
O4E EEO2 NZ» CKRIO ! WILL SEND AN EXTRA LINE ! 
OD4E DFEE SKPLNE ! SKIP ANOTHER LINE ! 
0050 DFB2 CHAR ! WAIT FOR EVER ! 

3331 CKRIO: 
ODS2 OAO? 3939 = 3332 RLis#’9? =| CK «IF PROGRAM GET LOADED ! 


541 


3333 ! OR MCZ STILL IN RIO ! 
0056 E60C 3334 Z> OKRET =! RETURN NZ FOR SOME ACKNOWL. ! 
0058 0A09 3030 3335 RLiy #70? 
ODSC £409 3336 Z» OKRET 
QDSE 0AQ9 3737 3337 CPB RL1y #°7? 
0D62 £606 3338 UR Zr OKRET 
3339 
3340 ! ECHO INPUT LINE RECEIVED FROM MCZ TO TERMINAL ! 
3H 
3342 QUTCH: 
0064 DFES 3343 CALR = MCZINP ! ECHO THE HCZ RESPONSE TO ! 
3344 ! TERMINAL ! 
3345 KEP: 
0066 D2F9 3346 CALR ~—sTYWR ! TERMINAL WHY 280 PRGRAM ! 
OD68 OAOB OAOA 3347 CPB RLO» $ASCILF ! DIDNOT GET LOADED. ! 
OBC 9E08 3348 RET Z ! BACK TO DEBUG ! 
ODSE EBFA 3349 AR QUTCH 
3350 
3351 
0070 8D43 3352 OKRET: RESFLGE Z ! RETURN NZ FOR RECEIVE ! 
0072 9EOB 3353 RET ! SOME ACKNOWLEDGE ! 
0074 3354 END SNDCMD 
3355 
3356 
0074 3357 GLOBAL SKPLNE PROCEDURE 
3358 
REND MEME iii tiiiiitifiiiiiitiiiiiiitiiiiitiiiitttt tit tit ti) ae 
3360 ! ! 
3361 ! SKPLNE SKIP OVER A INPUT LINE RECEIVED FROM HCZ. ! 
3362 ! INCLUDING ALL THE NULL CHARACTER AT THE END OF LINE ! 
3363 ! THE FIRST CHARACTER OF THE NEXT LINE WILL RETURN § ! 
3364 ! IN RLiy AND THE POINTER (MCZGET) STILL POINT TO ! 
3365 ! THE FIRST CHARACTER. ! 
3346 |! ! 
3367 | OUTPUT: RL1 - FIRST CHARACTER OF NEXT HCZ INPUT LINE! 
3348 ! RETURN Z IF ESCAPE KEY NOT HIT ! 
3369 ! RETURN NZ USER PRESS ESCAPE KEY ! 
3370 ! ! 
RKVAMEME TT iitiiiiiiiiiiiiitiiiiiiiiiiiiiiitittiitiiiti tt tit ae 
3372 
3373 ENTRY 
0074 DFED 3374 CALR MC ZINP ! SKIP OVER INPUT LINE! 
3375 ! UNTIL ALF ! 
0076 OA08 3376 CPB RLO,#ASCICR ! UNTIL ACR ! 
OD7A EEFC 3377 UR NZ» SKPLNE 
3378 
3379 
3380 ! SKIP OVER LINE FEED & NULL CHARACTER ! 
3381 ! WATT FOR A WHILE FOR THE NEXT CHARACTER TO COWE IN ! 
3382 
3383 
OD7C 2101 3000 3384 SKPNUL: LD Rir#Z3000 =! CONSTANT LOOF ! 
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O80 6100 
0D84 4B00 
O88 EE03 
ODBA ABO 
ODBC EEF? 
ODBE 9E06 


OD90 DFD2 


OD92 QAO? 
OD96 YEOD 
0D98 DFFF 
OD9A E8FO 


ODgC 


OD9C 


OD9C 6100 
ODAO 4B00 
ODA4 ESFB 


ODAS D2DC 
ODA éFO0 
ODAC 2028 
ODAE 9E08 


ODBO 


ODBO 


430A 
4308 


2020 


430A 
438 


430A 


3385 XX: 


3386 LD ROsMCZGET 

3387 CP RO,HCZPUT 

3388 JR NZ,GOTCHS 

3389 DEC Ri #1 WAIT... ! 

3390 JR NZ1XX 

31 RET Zz ! END OF LINE ! 

3392 

3393 GOTCHS: 

3394 CALR = MCHAR ! GET CHAR» BUT DON’T ADVANCE! 
3395 ! POINTER ! 

3396 

3397 CPB RLi,#’ ? =! LF & NULL ¢ SPACE ! 

3398 RET PL ! GOT ASCII CHAR ! 

3399 CALR = MCZINF ! SKIP THE LF OR NULL ! 

3400 UR SKPNUL 

3401 

3402 END SKPLNE 

3403 

3404 

3405 GLOBAL MCZINP PROCEDURE 

3406 

3407 ! JHBEBHHHBHBBHBHMHBBHMBHE EB HBHEEIHHBHEHEBE HEI EEIHEEE | 
3408 ! | 
3409 ! HCZINP GET A CHARACTER FROM THE MCZ INPUT INTERRUPT ! 
3410! BUFFER. IF NO CHARACTER IN THE BUFFER, IT WAIT.... ! 
34li ! ! 
3412 ! MCZPUT UPDATED TO POINT TO NEXT CHAR ! 
3413 ! CHARACTER RETURN IN RL1 ! 
3414 |! ! 
S415 | eH RO, R2 ARE LOST sien ! 
3416 ! | 
3417 | JBHBEHEHHEHHEHHHHHHHEHBREE HABE HBHOHBBHBHBGHHHE | 
3418 

3419 ENTRY 

3420 LD RO» NCZGET 

3421 Cr RO» HCZPUT ! CHECK ANY CHAR ! 

3422 JR Z» MCZINP ! NO, WAIT....  ! 

3423 

3424 CALR  MCZADR ! GET ADDRESS OF BUF ! 
3425 LD HCZGET» RO 

3426 LDB RLO, @R2 ! GET CHAR ! 

3427 RET ! WILL RETURN NZ ! 

3428 

3429 END MCZINP 

3430 

3431 


3432 GLOBAL MCZPTR PROCEDURE 


3433 
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3434 
3435 
3436 
3437 


iii a 
i | 
1 HCZPTR OUTPUT CHARACTER STREAM IN CONOBF TO MCZ/ZDS 
' SYSTEM. OUTPTR IS THE CONOBF ADDRESS CONTAINING 
3438 | THE LAST CHARACTER. 
3439 | THE LAST CHARACTER. IT ALSO ADD A CARRIAGE RETURN 
3440! TO THE END OF THE CHARACTER STREAM. 
3441 ! 
5442 ! 
5443! 
3444 |! 
3445 ! 
3446 ! 
3447 
3448 ENTRY 
ODBO 6102 3449 R2, QUTPTR 
ODB4 0C25 3450 OR2, #ASCICR | ADD CARRIAGE RETURN ! 
ODBE 4900 S451 QUTPTR» #1 
3452 
3453 HCZNCR: 
ODBC 2101 3494 Ri» #CONOBF 
ODCO 2018 3455 LOPS: LOB RLO» @R1 
ODC2 APLO 3496 INC Ri 
3457 
ODC4 DIC 3458 CALR = NCZSND ! SEND DATA TO MCZ 
OD £603 3499 AR Z1 ENDS 
3460 
3461 
ODCB 4B01 3462 CP Ri» QUIPTR ! CHECK IF ALL DONE ! 
OCC E7FY 34635 Cy LOPS ! NOT YET ! 
3464 
ODCE 4005 3465 ENDS: QUTPTR: #CONOBF 
ODD2 4130 
ODD4 2102 3466 R21 #COSIZE/2 
ODDB AB20 3467 R2,#1 
ODDA 4005 3468 CONOBF, #’ ? 
ODDE 2020 
ODEO 2100 3469 RO» #CONOBF 
ODE4 2101 3470 Riv &CONOBF+2 
ODEB BBOL 3471 @Rir @RO, R2 | BLANK BUFFER ! 
ODEC 9EOB 3472 


INPUT: DATA IN CONOBF, QUTPTR 
OUTPUT: GUTPTR = #CONOBF, BLANK IN CONOBF BUFFER 


! 
! 
! 
! 
! 
! 
! 
! 
! 
| 
! 


JHBHEHBHB GE HBHHEHEHHEHB HEHEHE BEIGHEEHH HEHEHE E 


3473 
ODEE 3474 END HCZPTR 
3475 
3476 
ODEE 3477 GLOBAL MCHAR PROCEDURE 
3478 ENTRY 
3479 
ODEE 6100 3480 LD ROSHCZGET 
ODF2 4800 3481 cP ROHCZPUT 
ODF6 EOFB 3482 JR Z+HMCHAR 
ODF8 D305 3483 CALR —-MCZADR 
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ODFA 2029 


ODFC 9EOB 


ODFE 


ODFE 


ODFE 2100 
0E02 6F00 
0E06 4005 
OE0A 4132 
OEOC DO2F 
OE0E 9608 
0E10 


OE10 


E10 09 
OE11 42 
OE12 41 
E13 44 
E14 20 
OE1S 44 
E16 41 
E17 54 
E18 41 
OEL? OD 


OE1A 19 

OE1B 2F49 
QE1D 4£43 
OEIF 4F52 
E21 5245 
0E23 4354 
0£25 204C 
E27 4F41 
OE29 4420 
OE2B 4144 
OE2D 4452 
OE2F 4553 
OE31 5320 
E33 OD 


0E34 OD 
E35 2F43 


2F2F 
4130 
43B6 


3493 | SEND ASCII 4//? TO HCZ TO ABORT THE 780 SEND PRGRAM ! 


RL1sBR2 


! WILL RETURN Z FRO ! 
! HWCZADR ROUTINE ! 


RO, #//! 
CONOBF »RO 
OUTPTR» #CONOBF+2 


MCZPTR 


3484 LDB 
3486 RET 
3487 

3488 END MCHAR 
3489 

3490 

3491 GLOBAL SNDERR PROCEDURE 
3492 

3494 

3495 ENTRY 

3496 LD 
5497 LD 
3498 LD 
3499 CALR 
3500 RET 
3501 END SNDERR 
3502 

3903 


3504 GLOBAL MSG PROCEDURE 


3505 ENTRY 

3506 BADAT: 

3507 BVAL 
3508 BYAL 
3509 BVAL 
3510 BVAL 
3ol1 BYVAL 
3512 BVAL 
3513 BYVAL 
3514 BVAL 
$515 BVAL 
3516 BVAL 
3517 

3518 ADBNSG:BVAL 
SOL? HVAL 
3520 HVAL 
3521 WVAL 
3522 WVAL 
3523 WAL 
3524 WAL 
3525 HVAL 
3926 WVAL 
3927 WAL 
3528 HVAL 
3529 HVAL 
3530 WAL 
3531 BVAL 
3932 

3533 ABNSG: BUAL 
5054 WVAL 


545 


546 


E37 4B53 
0E39 5540 
OE3B 2045 
OE3D 5252 
OESF 4FO2 
OE41 OD 


QE42 13 

0E43 2F46 
OE45 494C 
0E47 4520 
OE49 9752 
OE4B 4994 
OE4D 4520 
OE4F 4552 
ESL S24F 
E53 5220 
QE55 0D 


E56 11 

E57 2F4F 
E59 3045 
OESR 4E20 
OESD 4649 
OESF 4€45 
E61 2045 
E43 5252 
O65 4F52 
0£67 0D 


OE6B 07 
E69 2F41 
OE6B 424F 
9E6D 5254 
OESF OD 


0E70 454€ 
E72 5452 
0E74 5920 
0E76 S04F 
E78 494€ 
QE7A 5420 
OE7E 


E70 


OE70 3020 
OE7E 3120 
0€80 3220 
E82 3320 
0E84 3420 


3539 


3536 HVAL 
3537 VAL 
3538 WAL 
3939 HVAL 
3340 BYAL 
3541 

3542 FLEMSG:BVAL 
3543 VAL 
3544 WVAL 
3545 HVAL 
3546 WAL 
3547 HVAL 
3548 WVAL 
3549 WVAL 
3550 WAL 
3501 HVAL 
3592 BVAL 
3553 

3554 OPNHSG:BVAL 
3599 HVAL 
3556 WVAL 
3997 WVAL 
3558 HVAL 
3559 HVAL 
3560 WAL 
3561 HVAL 
3562 WVAL 
3563 BYAL 
3564 

3565 ESCHSGSBYAL 
3566 WVAL 
3567 WVAL 
3968 WVAL 
34? BYAL 
3570 

3571 ENTR? WVAL 
5972 WVAL 
3573 HVAL 
3574 WVAL 
3979 VAL 
3576 VAL 
3577 END MSG 
3578 

3579 

3580 GLOBAL HESSX PROCEDURE 
3581 ENTRY 

3582 LRO: = -HVAL 
3583 HVAL 
3584 VAL 
3585 HVAL 
3586 LR4: VAL 


7? 
Bt ? 
97! 
13? 
rt 


0E86 3520 3587 HVAL 
E88 3620 3588 WAL 
OEBA 3720 3589 HVAL 
ERC 3820 3570 LR8: —RVAL 
ESE 3920 3571 HVAL 
E90 3130 5592 WAL 
OE92 3131 3593 WVAL 
E94 3132 3594 LR12: == HVAL 
£96 3133 3595 WVAL 
OE98 3134 3596 LRI4: — HVAL 
OEPA 3135 3997 LRIS! = WVAL 
OEE 5043 3598 LPC: = WVAL 
OEDE 4643 3599 LEC? AVAL 
OEAO 524C 3600 LIT: =~ HVAL 
OEA2 5248 3601 WVAL 
OEA4 09 3602 BRKNSG: BVAL 
OEAS 42 3603 BVAL 
OEAG 5249 3604 WAL 
OEAB 4148 3605 HVAL 
OEAA 2041 3606 WAL 
OEAL 3420 3607 WVAL 
OEAE 05 3608 NHINSG: BVAL 
OEAF 4E 3609 BYVAL 
OEBO 4049 3610 WAL 
OEB2 20 3611 BYVAL 
OEBS OD 3612 BVAL 
OEB4 3613 END HESSX 
3614 
3615 
OEB4 3616 GLOBAL INTER PROCEDURE 
3617 ENTRY 
3618 RAMDTA: 
OEB4 40B0 5619 HVAL — CONTBF ! INPTR ! 
OEBS 4130 3620 WVAL = CONOBF ! QUTPTR ! 
OEBB 08 3621 BYVAL — BACKSP 1 CHRDEL ! 
EB) 7F 3622 BVAL —CDELTE ' LINDEL ! 
OEBA 11 3623 BVAL = XONC ! XONCHR ! 
OEBB 13 3624 BVAL == XOFFC ! XOFCHR ! 
OEBC 0000 3625 HVAL 0000 ! NULLCT ! 
OEBE 0E00 3626 HVAL = %20E00 1 TLEGAL INSTURCTION! 
OECO 0004 3627 WVAL = — 20004 ! COUNT FOR CTC3 ! 
OEC2 0001 3628 WAL = 40001 ! N. COUNT FOR BREAK & NEXT ! 
3629 
3630 
3631 
OEC4 18 3632 INIOUT? BYVAL %(2)00011000 =! BIT 31475 CHANNEL RESET ! 
OECD 02 BVAL 2 ! WRITE REG 2 ! 
OEC4 10 BVAL = £10 ! INTERRUPT VECTOR 10 ! 


OEC7 14 4(2)00010100 =! BIT 3-5 RESET EXTERNAL/ ! 
! STATUS INTERRUPT ! 
! BIT Ovke2 WRITE REG 4 ! 
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occa CC 


OEC? 03 
OECA Ci 


OECD 11 


BYAL 


BYVAL 
BYVAL 


BYVAL 
BVAL 


BYVAL 


BYVAL 


3682 
3683 HCZOUT: BVAL 


3484 


BYVAL 


4(2) 11001100 


3 
%(2) 11000001 


5 
4(2) 11101010 


%(2) 00010001 


4(2)00011100 


4(2)00011000 
4(2)00010100 


%(2) 11001100 


BIT 01 NO PARITY ! 

BIT 2.3 THO STOP BITS ! 
BIT 425 EIGHT BITS SYNC! 
BIT 617 CLOCK RATE X 64! 


WRITE REG 3 ! 

BIT 0 RECEIVE ENABLE ! 
BIT 1 NO SYNC CHAR LOAD! 
INHIBIT ! 

BIT 2 NO ADDRESS SEARCH ! 
MODE ! 

BIT 3 NO CRC ENABLE ! 

BIT 4 NO HUNT MODE ! 

BIT 5 NO AUTO ENABLE ! 
BIT +7 EIGHT BITS PER ! 
CHAR ON RECIVED ! 


WRITE REG 5 ! 

BIT © X/HIT CRC DISABLE! 
BIT 1 RTS ACTIVE ! 

BIT 2 SDLC/CRC16 DISABLE! 
BIT 3 X’HIT ENABLE ! 

BIT 4 NO SEND BREAK ! 
BIT 526 EIGHT BIT/CHAR! 
ON X'HIT ! 

BIT 7 BTR ACTIVE ! 


1 BIT 3-5 RESET EXTERNAL/! 


STATUS INTERRUPT ! 


| BIT Ovi? WRITE REG 1 ! 


! BIT 0 EXTERNAL ! 


INTERRUPT OFF ! 


1 BIT 1 XYNIT INTERR.OFF! 
1 BIT2 STATUS ASFFECT! 


VECTOR ! 


| BIT 34 RECEIVE ! 


INTERRUPT ENABLE ! 


| BIT X WAIT READY DISABLE! 


! BIT 32415 CHANNEL RESET ! 


1 BIT 3-5 RESET EXTERNAL/ ! 


STATUS INTERRUPT ! 


| BIT Orie? WRITE REG 4 ! 


BIT Ori NO PARITY ! 
BIT 23 THO STOP BITS ! 


3691 

3692 

3693 

5694 BVAL = 3 

3695 BVAL = (211000001 

3696 

5697 

3698 

3699 

3700 

3701 

3702 

3703 

3704 

3705 
OEDS 05 3706 BVAL = 
OEDS EA 3707 BVAL = -&(2) 11101010 

3708 

3709 

3710 

3711 

3712 

3713 

3714 

3715 

3716 BAL == %(2)00010001 ! BIT 3-5 RESET EXTERNAL/! 

3717 ! STATUS INTERRUPT ! 

3718 ! BIT Ortr2 WRITE REG 1 ! 

3719 
OED8 18 3720 BAL (2) 00011000 ! BIT 0 EXTERNAL ! 

3721 ! INTERRUPT OFF ! 

3722 ! BIT 1 X/MIT INTERR.OFF! 

3723 1 BIT2 NO STATUS ASFFECT! 

3724 ! VECTOR ! 

3729 ! BIT 3.4 RECEIVE ! 

3726 ! INTERRUPT ENABLE ! 

3727 ! BIT X WAIT READY DISABLE! 
OED? 00 3728 

3729 

3730 

3731 

3732 

3733 
OEDA 0000 3734 PSBLK: VAL 
OEDC 0000 37355 HVAL 
OEDE 4000 3736 WAL 
OEEO 0000 3737 VAL 
OEE2 0000 3738 WVAL 
OEE4 0000 37359 HVAL 
OEE6 0000 3740 WAL 
OEEB 0000 3741 VAL 
OEEA 0000 3742 WAL 


BIT 415 EIGHT BITS SYNC! 
BIT 677 CLOCK RATE X 44! 


WRITE REG 3 ! 

BIT 0 RECEIVE ENABLE ! 

BIT i NO SYNC CHAR LOAD! 
INHIBIT ! 

BIT 2 NO ADDRESS SEARCH ! 
MODE ! 


BIT 3 NO CRC ENABLE ! 
BIT 4 NO HUNT HODE ! 
BIT 5 NO AUTO ENABLE ! 
BIT 6+7 EIGHT BITS PER ! 
CHAR ON RECIVED ! 


WRITE REG 5 ! 

BIT 0 X’HIT CRC DISABLE! 
BIT 1 RTS ACTIVE ! 

BIT 2 SDLC/CRC16 DISABLE! 

BIT 3 X’HIT ENABLE ! 

BIT 4 NO SEND BREAK ! 

BIT 516 EIGHT BIT/CHAR! 
ON X’MIT ! 

BIT 7 DIR ACTIVE ! 


! RESERVED ! 


S 


! NON-IMPLEMENTED INSTRUCT ! 
! BREAK INTERRUPT ADDR ! 
! PREVILEGED INSTRUCTIONS ! 


! SYSTEM CALL ! 


oocococcoe xc oS 


! SEGMENTATION TRAP ! 
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OEEC 0000 3743 
QEEE 4000 5744 ! NON-HASKABLE INTERRUPT! 
OEFO 0000 3745 ! RETURN TO MONITOR HODE ! 
OEF2 0000 3746 1 NON-VECTORED INTERRUPT ! 
OEF4 0000 3747 
EFS 4000 3748 ! VECTORED INTERRUPT - FCW ! 
OEFB 0000 3749 ! VECTOR 0! 
OEFA 0000 3750 ! VECTOR 1 ! 
OEFC 0000 3751 ! VECTOR 2 ! 
OEFE 0000 3752 ! VECTOR 3 ! 
OFO0 0000 3753 ! VECTOR 4 ! 
OFO2 0000 3754 ! VECTOR 5 ! 
OFO4 0000 3799 1 VECTOR 4 CTC3 BREAK & NEXT! 
OF04 0000 3736 ! VECTOR 7 ! 
OFOB 0000 3757 ! VECTOR 8 ! 
OFOA 0000 3758 ! VECTOR 9 ! 
OFOC 0000 3759 ! VECTOR A ! 
OFOE 0000 3760 ! VECTOR B ! 
OFL0 0000 3761 ! VECTOR OC ! 
OF12 0000 3742 ! VECTOR OD ! 
OF 14 0000 3763 1 VECTOR OE ! 
OF16 0000 3764 ! VECTOR OF ! 
3765 
OF18 0000 3766 ! VECTOR 10 FOR SYO CHIP! 
OFLA 0000 3767 1 VECTOR 11 ! 


oocococococeococeco 


OFIC 0000 3768 ! VECTOR 12 ! 


OFIE 0000 3769 

OF20 0000 3770 

OF22 0000 3771 

OF24 0000 3772 

0F26 0000 3773 

OF28 0000 774 

OF2A 0000 3775 

OF2C 0000 3776 

OF2E 0000 3777 

OF30 0000 3778 

OF32 0000 3779 

OF34 0000 3780 

OF36 9000 3781 
3782 
3783 
3784 1 CTC VALUE BAUDE RATE SETTING ! 

OF38 AF 3785 SHTBL! = BVAL = 175 1110 (0) ! 

OFS? 8F 3786 BVAL = «143 1134.5 (1) ! 

OFSA 80 3787 BVAL = -128 ' 150 (2) ! 

OF3B 60 3788 BVAL 98 1 200 (3) | 

OF3C 40 3789 BYVAL 64 1 300 (4) ! 

OF3B 20 3790 BUAL =. 32 1 400 (5) ! 

OFSE 10 3791 BYVAL = 16 1 1200 (6) ! 

OF3F 08 3792 BVAL 1 2400 (7) ! 

OF40 04 3793 BYVAL ! 4800 (8) ! 

OF41 02 3794 BYVAL 1 9600 (9) | 


! VECTOR 13 ! 

! VECTOR 14 FOR CH.B KB ! 

! VECTOR 15 ! 

1 VECTOR 16 CHB SP.REC.COND. ! 
1 VECTOR 17 ! 

1 VECTOR 18 ! 

! VECTOR 19 ! 

! VECTOR 1A ! 

1 YCTORE 1B ! 

1 VECTOR LC CH.A MCZ INPUT ! 
1 VECTOR 1D ! 

! VECTOR 1€ CHA SP.REC.COND ! 
! VECTOR LF ! 


eocceoceccocooo S&S 
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OF42 01 
OF43 01 
OF44 01 
OF45 O1 
OF46 01 
OF4? O1 


OFAO SEOB 
OFA4 JE08 
OFAB 5E0B 
OFAC SE08 
OFBO SE08 
OFB4 SE08 
OFBB SEOB 
OFBC 5E08 
OFCO SEOB 
OFC4 SE08 
OFCB SEOB 
OFC SE08 
OFDO SE08 
OFD4 SE08 
OFD8 SE08 


OFDC SE08 
OFEO 5E08 
OFE4 SE08 
OFEB SE08 
OFEC SE08 


OFFO 


3795 
3796 
3797 
3798 
3799 
3800 
3891 
3802 


BVAL 
BYVAL 
BVAL 
BUAL 
BYVAL 
BYAL 


3803 $REL ZOFA0 


3804 
3805 
3806 
3807 
3808 
3809 
3810 
381i 
3812 
3813 
3814 
3815 
3816 
3817 
3818 
3B19 
3820 
3821 
3822 
3823 
3824 
3825 
3826 
3827 END INTER 
3828 
3829 END ZDISF 


LAY 


TYIN 
CONVERT 
NXTARG 
LOD2 
GETADN 
PUT2 
PUTL 
PUTPTR 
PUTNSG 
GETNUH 
TYHR 
PUTNCR 
EROR 
CRLF 
HCZSND 
TTY 
TTYRD 
SKIPSP 
GCHAR 
GET 


1 19200 (A) ! 
1 19200 (B) ! 
1 19200 (C) ! 
! 19200 (D) ! 
1 19200 (E) ! 
1 19200 (F) ! 
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Product Specification 


Lf YA EMIT KAAS Hy KN 
BU AL STE TST 
ava sea BY 
ree BOD IER as 


ierey 


(ST 
Rae 


BS 
ALL 


é 
oo 
= 
oe 
¥ 

= 

_ 
il 
wat 


peo? vere Ne iy ely 
ian AG 


a ae Br 


y § 
Nes } 


Z8001 CPU 
28002 CPU 


Y, Product 
Zilog Specification 


Preliminary 
Features Regular, easy-to-use architecture Resource-sharing capabilities for multi- 

C1 Instruction set more powerful than many processing systems 
minicomputers Multi-programming support 

O Directly addresses eight megabytes Compiler support 
Eight user-selectable addressing modes 1 Memory management and protection pro- 

© Seven data types that range from bits to vided by 28010 Memory Management Unit 
32-bit long words and word strings 0) 32-bit operations, including signed multiply 

and divide 


System and normal operating modes 


0 Z-Bus compatible 
4 MHz clock rate 


Se SS ee eS 

General The Z8000 is an advanced high-end 16-bit 

Description microprocessor that spans a wide variety of Bus 
applications ranging from simple stand-alone ziMinG 
computers to complex parallel-processing 
systems. Essentially, a monolithic minicom- 
puter central processing unit, the Z8000 CPU 
is characterized by an instruction set more 
powerful than many minicomputers; resources 
abundant in registers, data types, addressing 
modes and addressing range; and a regular 
architecture that enhances throughput by 
avoiding critical bottlenecks such as implied or 
dedicated registers. 

CPU resources include sixteen 16-bit 
general-purpose registers, seven data types CONTROL 
that range from bits to 32-bit long words and 
word strings, and eight user-selectable ad- 
dressing modes. The 110 distinct instruction 
types can be combined with the various data 
types and addressing modes to form a powerful — urtimicro 
set of 414 instructions. Moreover, the instruc- CONTROL 
tion set exhibits a high degree of regularity: SESH TRAP | 
ost jnsimietionscanwadeny ofthe five mailACT ion) kemy Mblbnlims oi = 
addressing modes and can operate on byte, 
word and long-word data types. +5V GND CLK RESET 

The CPU can operate in either the system or 
normal modes. The distinction between these 
two modes permits privileged operations, Figure 1. Z8000 CPU Pin Functions 
thereby improving operating system organiza- 
tion and implementation. Multiprogramming of instruction and hardware features; and com- 
is supported by the “atomic’’ Test and Set pilers by multiple stacks, special instructions 
instruction; multiprocessing by a combination and addressing modes. 


Separate code, data and stack spaces 


Sophisticated interrupt structure 


ADDRESS/ 


STATUS DATA BUS 


cP 
CONTROL 


zso0o01 
ONLY | 


seGmeEnt | 
NUMBER | 


| 


INTERRUPTS 


a c 
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General 
Description 
(Continued) 


The Z8000 CPU is offered in two versions: 
the Z8001 48-pin segmented CPU and the 
Z8002 40-pin non-segmented CPU. The main 
difference between the two is in addressing 
range. The Z8001 can directly address 8 mega- 
bytes of memory; the Z8002 directly addresses 
64 kilobytes. The two operating modes-system 
and normal-and the distinction between code, 
data and stack spaces within each mode allows 
memory extension up to 48 megabytes for the 
Z8001 and 384 kilobytes for the Z8002. 

To meet the requirements of complex, 
memory-intensive applications, a companion 


memory-management device is offered for the 
Z8001. The Z8010 Memory Management Unit 
manages the large address space by providing 
features such as segment relocation and 
memory protection. The Z8001 can be used 
with or without the Z8010. If used by itself, the 
Z8001 still provides an 8 megabyte direct 
addressing range, extendable to 48 megabytes. 

The Z8001, Z8002 and Z8010 are fabricated 
with high-density, high-performance scaled 
n-channel silicon-gate depletion-load tech- 
nology, and are housed in dual in-line 
packages. 


ee ee — OOo — — — 


Register 


The Z8000 CPU is a register-oriented 


Organization machine that offers sixteen 16-bit general- 


Stacks 
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purpose registers and a set of special system 
registers. All general-purpose registers can be 
used as accumulators and all but one as index 
registers or memory pointers. 

Register flexibility is created by grouping 
and overlapping multiple registers (Figures 2 


RQ4 


Ras 


RQI2 


R14 SYSTEM STACK POINTER (SEG. NO.) 
R14 NORMAL STACK POINTER (SEG. NO.) 


RIS SYSTEM STACK POINTER (OFFSET) 
RI5 NORMAL STACK POINTER (OFFSET) 


Figure 2. Z8001 General-Purpose Registers 


The Z8001 and Z8002 can use stacks located 
anywhere in memory. Call and Return instruc- 
tions as well as interrupts and traps use im- 
plied stacks. The distinction between normal 
and system stacks separates system information 
from the application program information. Two 
stack pointers are available: the system stack 
pointer and the normal stack pointer. Because 
they are part of the general-purpose register 


and 3). For byte operations, the first eight 
16-bit registers (RO...R7) are treated as sixteen 
8-bit registers (RLO, RHO, ... , RL7, RH7). The 
sixteen 16-bit registers are grouped in pairs 
(RRO ... RR14) to form 32-bit long-word 
registers. Similarly, the register set is grouped 
in quadruples (RQO ... RQ12) to form 64-bit 
registers. 
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RQB 


R10 
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Figure 3. Z8002 General-Purpose Registers 


group, the user can manipulate the stack 
pointers with any instruction available for 
register operations. 

In the Z8001, register pair RR14 is the 
implied stack pointer. Register R14 contains 
the 7-bit segment number and R15 contains the 
16-bit offset. In the Z8002, register R15 is the 
implied 16-bit stack pointer. 


Refresh 


The Z8000 CPU contains a counter that 
can be used to automatically refresh dynamic 
memory. The refresh counter register consists 
of a 9-bit row counter, a 6-bit rate counter and 
an enable bit (Figure 4). The 9-bit row counter 
can address up to 256 rows and is incremented 
by two each time the rate counter reaches 
end-of-count. The rate counter determines the 
time between successive refreshes. It consists 
of a programmable 6-bit modulo-n prescaler 


(n = 1 to 64), driven at one-fourth the CPU 
clock rate. The refresh period can be pro- 
grammed from 1 to 64 ws with a 4 MHz clock. 
Refresh can be disabled by programming the 
refresh enable/disable bit. 


15 ° 


Figure 4. Refresh Counter 


Program 
Status 
Information 


This group of status registers contains the 
program counter, flags and control bits. When 
an interrupt or trap occurs, the entire group 
is saved and a new program status group is 
loaded. 

Figure 5 illustrates how the program status 
groups of the Z8001 and Z8002 differ. In the 
non-segmented Z8002, the program status 
group consists of two words: the program 
counter (PC), and the flag and control word 
(FCW). In the segmented Z8001, the program 
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Z8001 Program Status Registers 


15 0 
| o | SEGMENT NUMBER a ee en 
UPPER OFFSET Diaiiie Satie. o.oo © 


Z8001 Program Status Area Pointer 


PROGRAM 
COUNTER 


status group consists of four words: a two-word 
program counter, the flag and control word 
and an unused word reserved for future use. 
Seven bits of the first PC word designate one 
of the 128 memory segments. The second word 
supplies the 16-bit offset that designates a 
memory location within the segment. 

With the exception of the segment enable bit 
in the Z8001 program status group, the flags 
and control bits are the same for both CPUs. 
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Z8002 Program Status Registers 


15 


UPPER POINTER Died Ol Oh Oho. \@ P20 


Z8002 Program Status Area Pointer 


Figure 5. Z8000 CPU Special Registers 


Interrupt 
and Trap 
Structure 


The Z8000 provides a very flexible and 
powerful interrupt and trap structure. Inter- 
rupts are external asynchronous events requir- 
ing CPU attention, and are generally triggered 
by peripherals needing service. Traps are syn- 
chronous events resulting from the execution 
of certain instructions. Both are processed in a 
similar manner by the CPU. 

The CPU supports three types of interrupts 
(non-maskable, vectored and non-vectored) 
and four traps (system call, unimplemented 
instruction, privileged instructions and 
segmentation trap). The vectored and non- 
vectored interrupts are maskable. Of the four 
traps, the only external one is the segmenta 
tion trap, which is generated by the Z8010. 

The remaining traps occur when instructions 
limited to the system mode are used in the nor- 
mal mode, or as a result of the System Call in- 
struction, or for an unimplemented instruction. 
The descending order of priority for traps 


and interrupts is: internal traps, non-maskable 
interrupt, segmentation trap, vectored inter- 
rupt and non-vectored interrupt. 

When an interrupt or trap occurs, the cur- 
rent program status is automatically pushed on 
the system stack. The program status consists 
of the processor status (PC and FCW) plus a 
16-bit identifier. The identifier contains the 
reason or source,of the trap or interrupt. For 
internal traps, the identifier is the first word 
of the trapped instruction. For external traps 
or interrupts, the identifier is the vector on the 
data bus read by the CPU during the 
interrupt-acknowledge or trap-acknowledge 
cycle. 

After saving the current program status, the 
new program status is automatically loaded 
from the program status area in system 
memory. This area is designated by the pro- 
gram status area pointer (PSAP). 
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Data 
Types 


Z8000 instructions can operate on bits, BCD 
digits (4 bits), bytes (8 bits), words (16 bits), 
long words (32 bits), byte strings and word 
strings (up to 64 kilobytes long). Bits can be 
set, reset and tested; digits are used in BCD 
arithmetic operations; bytes are used for 
characters or small integer values; words are 
used for integer values, instructions and non- 
segmented addresses; long words are used for 


long integer values and segmented auuresses. 
All data elements except strings can reside 
either in registers or memory. Strings are 
stored in memory only. 

The basic data element is the byte. The 
number of bytes used when manipulating a 
data element is either implied by the operation 
or-for strings and multiple register opera- 
tions- explicitly specified in the instruction. 


—_—__ eee 


Segmen- 
tation and 
Memory 
Management 


High-level languages, sophisticated operat- 
ing systems, large programs and data bases, 
and decreasing memory prices are all accel- 
erating the trend toward larger memory 
requirements in microcomputer systems. The 
Z8001 meets this requirement with an eight 


megabyte addressing space. This large 
address space is directly accessed by the CPU 
using a segmented addressing scheme and can 
be managed by the Z8010 Memory Manage- 
ment Unit. 


—_—_—_———————————————————————————————— 


Segmented 
Addressing 


A segmented addressing space - compared 
with linear addressing-is closer to the way a 
programmer uses memory because each pro- 
cedure and data space resides in its own seg- 
ment. The 8 megabytes of Z8001 addressing 
space is divided into 128 relocatable segments 
up to 64 kilobytes each. A 23-bit segmented 
address uses a 7-bit segment address to point 
to the segment, and a 16-bit offset to address 
any location relative to the beginning of the 
segment. The two parts of the segmented 
address may be manipulated separately. The 
segmented Z8001 can run any code written for 
the non-segmented Z8002 in any one of its 
128 segments, provided it is set to the non- 
segmented mode. 


In hardware, segmented addresses are con- 
tained in a register pair or long-word memory 
location. The segment number and offset can 
be manipulated separately or together by all 
the available word and long-word operations. 

When contained in an instruction, a 
segmented address has two different represen- 
tations: long offset and short offset. The long 
offset occupies two words, whereas the short 
offset requires only one and combines in one 
word the 7-bit segment number with an 8-bit 
offset (range 0-256). The short offset mode 
allows very dense encoding of addresses and 
minimizes the need for long addresses 
required by direct accesssing of this large 
address space. 


Memory 


The addresses manipulated by the program- 


Management mer, used by instructions and output by the 
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Z8001 are called logical addresses. The 
Memory Management Unit takes the logical 
addresses and transforms them into the 
physical addresses required for accessing the 
memory (Figure 6). This address transforma- 
tion process is called relocation. Segment 
relocation makes user software addresses inde- 
pendent of the physical memory so the user is 
freed from specifying where information is 
actually located in the physical memory. 

The relocation process is transparent to user 
software. A translation table in the Memory 
Management Unit associates the 7-bit segment 
number with the base address of the physical 
memory segment. The 16-bit offset is added to 
the physical base address to obtain the actual 
physical address. The system may dynamically 
reload translation tables as tasks are created, 
suspended or changed. 

In addition to supporting dynamic segment 
relocation, the Memory Management Unit also 
provides segment protection and other seg- 
ment management features. The protection 
features prevent illegal uses of segments, such 
as writing into a write-protected zone. 

Each Memory Management Unit stores 64 
segment entries that consist of the segment 


base address, it attributes, size and status. 
Segments are variable in size from 256 bytes to 
64 kilobytes in increments of 256 bytes. Pairs 
of Management Units support the 128 segment 
numbers available for each of the six CPU 
address spaces. Within an address space, 
several Management Units can be used to 
create multiple translation tables. 


Figure 6. Logical-to-Physical Address 
Transformation 


Addressing 
Modes 


The information included in Z8000 instruc- 
tions consists of the function to be performed, 
the type and size of data elements to be 
manipulated and the location of the data 
elements. Locations are designated by register 
addresses, memory addresses or I/O 
addresses. The addressing mode of a given 
instruction defines the address space it refer- 
ences and the method used to compute the 
address itself. Addressing modes are explicitly 
specified or implied by the instruction. 


Figure 4 illustrates the eight addressing 
modes: Register (R), Immediate (IM), Indirect 
Register (IR), Direct Address (DA), Indexed 
(X), Relative Address (RA), Base Address (BA) 
and Base Indexed (BX). In general, an ad- 
dressing mode explicitly specifies either 
register address space or memory address 
space. Program memory address space and 
I/O address space are usually implied by the 
instruction. 


Mode Operand Addressing Operand Value 
In the Instruction In a Register In Memory 
7 Th tent of th 
Register alan 
Immediate In the instruction 
: The content of the location 
antec [aooness | whose address is in the 
Register register 
Direct The content of the location 
| ADDRESS | } OPERAND | whose address is in the 
Address instruction 
The content of the location 
whose address is the 
Index | Base apoRess _| i a address in the instruction, 
Base ADORE: © offset by the content of 
the working register 
The content of the location 
[rovawwe | whose address is the 
i content of the program 
Relative [ pisPLacemeNT | (+) OPERAND counter, offset by the 
Address displacement in the 
instruction 
The content of the location 
Base [asenannen}-~[oseaones |} —y winasiaoe te 
OPERAND address in the register, 
Address O aaa] offset by the displacement 
in the instruction 
The content of the location 
Base [reourensoonns | [oat ores | — whose adress is the 
address in the register. 
os as © offset by the displace- 


ment in the register 


Figure 7. Addressing Modes 
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Input/ 
Output 


A set of I/O instructions performs 8-bit or 
16-bit transfers betwen the CPU and I/O 
devices. I/O devices are addressed with a 
16-bit I/O port address. The I/O port address 
is similar to a memory address; however, I/O 
address space is not part of the memory 
address space. I/O port and memory addresses 
coexist on the same bus lines and they are 
distinguished by the status outputs. 


Two types of I/O instructions are available: 
standard and special. Each has its own address 
space. Standard I/O instructions include a 
comprehensive set of In, Out and Block I/O 
instructions for both bytes and words. Special 
I/O instructions are used for loading and 
unloading the Memory Management Unit. The 
status information distinguishes between stan- 
dard and special I/O references. 


—_—eoo 


Multi- 
Micro- 
Processor 
Support 


Multi-microprocessor systems are supported 
in hardware and software. A pair of CPU pins 
is used in conjunction with certain instructions 
to coordinate multiple microprocessors. The 
Multi-Micro Out pin issues a request for the 
resource, while the Multi-Micro In pin is used 
to recognize the state of the resource. Thus, 
any CPU in a multiple microprocessor system 
can exclude all other asynchronous CPUs from 
a critical shared resource. 


Multi-microprocessor systems are supported 
in software by the instructions Multi-Micro 
Request, Test Multi-Micro In, Set Multi-Micro 
Out and Reset Multi-Micro Out. In addition, 
the eight megabyte CPU address space is 
beneficial in multiple microprocessor systems 
that have large memory requirements. 


—_—_e a — 


Instruction 
Set 
Summary 


The Z8000 provides the following types of 
instructions: 


Load and Exchange 
O Arithmetic 


0 Logical 


O Program Control 


O Bit Manipulation 

O Rotate and Shift 

O Block Transfer and String Manipulation 
O Input/Output 

O CPU Control 


eee 
Clock Cycles* 


Load 
and 
Exchange 


Mnemonics Operands Addr. Word, Byte Long Word Operation 
Mocs “Rs 68 §L KS 68. BL 

CLR dst R Z. - - Clear 
CLRB IR 8 - - dst — 0 

D a 12 14 

X 11 12 15) 
EX R, sre R 6 - - Exchange 
EXB IR ee - R = sre 

DA 1516-18 

X 16" 16; 19 
LD R, sre R 3 - - 5 ~ - Load into Register 
LDB IM 7 - - ll - ~ R = sre 
LDL IM 5 (byte only) 

IR 7 - - ll - - 

DA See elOr 20Z 125) 

X IO) 10; Ws 13 18 16 

BA 14 - - 17 - - 

BX 14 - - 17 - - 

LD dst, R IR 8 - - 11 - - Load into Memory (Store) 
LDB DA 11 120) 14 14 S17 dst — R 
LDL xX LZ 12 Sas 15) dose 13: 

BA 14 - - 17. - - 

BX 14 - - 17 - - 
a rrr 
LD dst, IM IR ll - - Load Immediate into Memory 
LDB DA Ene Uma £7 dst — IM 

X 15 15 18 


* NS = Non-Segmented SS = Segmented Short Offset SL = Segmented Long Offset 
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Load and Clock Cycles 
Exchange 
g Mnemonics Operands Addr. Word, Byte Long Word Operation 
(Continued) Mod: 
see? NS i8S' (SE NS SS SL 
LDA R, src DA 12) SSS Load Address 
xX 13 13; S16 R = source address 
BA 15° = - 
BX 15\ 3S - 
LDAR R, src RA 15 . - Load Address Relative 
R — source address 
LDK R, sre IM Bh? t= - Load Constant 
R=—n(n =0... 15) 
LDM R,src,n IR Di} - - Load Multiple 
DA 14 15° B17 +3n R — src (n consecutive words) 
X 15 15 18 (assed 5.226) 
LDM dst, R,n IR 1] - - Load Multiple (Store Multiple) 
DA 14) 1S; Me, +3n dst — R (n consecutive words) 
X 1B. 5 8 (n = 2... 16) 
LDR R, sre RA 14 - - 17 - - Load Relative 
LDRB R = src 
LDRL (range -32768 ... + 32767) 
LDR dst, R RA 14 - - 17 - - Load Relative (Store Relative) 
LDRB dst — R 
LDRL (range -32768 ... + 32767) 
POP dst, IR R S := - 1259 - Pop 
POPL IR i2- = - 19° = - dst — IR 
DA 15 16 18 22, 23" 825) Autoincrement contents of R 
X 16. —16: . =19 a. 20> 26 
PUSH IR, src R 9 - T2  - - Push 
PUSHL IM 24S = ~ - - - Autodecrement contents of R 
IR 13 - - 20 - - IR =— src 
DA 1c Binge: apn 3} 20 2) 28 
xX 14 14 17 21 21 24 
Arithmetic ADC R, src R Oe = Add with Carry 
ADCB R —R + src + carry 
ADD R, src R 4 - - os = - Add 
ADDB IM vf - - 14 - - R —R + src 
ADDL IR 7 - - 14. - - 
DA £2 VE gi ian be 15m to) 718! 
X 1:7 1G). Se lor a6, 1S 
cP R, src R 4 - - Fa "ie - Compare with Register 
CPB IM ih - - 14 - - R - sre 
CPL IR 7S = - 14. - - 
DA OO. 15, 16 18: 
xX 10 10 13 16 16 19 
cP dst, IM IR 1] - - Compare with Immediate 
CPB DA 1A Se aly dst - IM 
X 15 15 18 
DAB dst R 525 - Decimal Adjust 
DEC dst,n R 4 - - Decrement by n 
DECB IR 11 - - dst — dst -n 
DA 1S 14 eile (ic 6) 
xX 14 14 17 
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Arithmetic 


Clock Cycles 


(Continued) Mnemonics Operands Addr. Word, Byte Long Word Operation 
Modes ows ss st “NS ss si 
DIV R, sre R 95 - - 723. - - Divide (signed) 
DIVL IM 95 - - 723° - - Word: Ry +] — Rh,ns1 + sre 
IR 95: = - 723 - - R, — remainder 
DA 96 97 99 924 725 727 Long Word: Ry+2.n+3 — Bn...n+3> 7° 
xX 97 97 100 725 725 728 n,n+] 7 remainder 
EXTS dst R 11 - - 11 - - Extend Sign 
EXTSB Extend sign of low order half of dst 
EXTSL through high order half of dst 
INC dst,n R 4 - - Increment by n 
INCB IR Ly Se = dst — dst + n 
DA 13) gl4 si6 (a = 1... 16) 
xX 14 #14 «17 
MULT R, src R 70 - - 282* - - Multiply (signed) 
MULTL IM 70 - . 282* - - Word: Ryn+1 — Rn+] * sre 
IR fOlm BE 3 282" = = Long Word: Ry. n+ 3—Rn+2, n+3° sre 
DA Y/Y 7 ere 283* 284* 286* *Plus seven cycles for each | in the 
X 72 FT ~35 284* 284* 287* multiplicand 
NEG dst R 7 - - Negate 
NEGB IR 125 - dst — 0 - dst 
DA 15; 26. 418 
xX 6; dg 15 
SBC R, sre R Bin ae - Subtract with Carry 
SBCB R — R = sre - carry 
SUB R, src R 4 a> ~ 8 - - Subtract 
SUBB IM 2 ae - 14 = - R — R-srec 
SUBL IR a - 1 ae e 
DA 9 10 12 15 16 18 
X 10 10 13 16 16 19 
Logical AND R, src R Ae ae AND 
ANDB IM ——— - R — R AND src 
IR 7 - - 
DA & 10. 
X 1 10: 8 
COM dst R y = - Complement 
COMB IR 12 = - dst — NOT dst 
DA 1S) (1é .1s 
X 1 .16 19 
OR R, src R 4. - - OR 
ORB IM 7 - - R — ROR sre 
IR 7) = - 
DA OOM 4 12 
xX 106 LO. 3 
TEST dst R 2 = - 3 = - Test 
TESTB IR A= - Is = - dst OR 0 
TESTL DA I p12)", 14 16: 17 19 
xX 12 We 5: lz i, 520 
TCC cc, dst R 5 = - Test Condition Code 
TCCB Set LSB if cc is true 
XOR R, src R 4 - ~ Exclusive OR 
XORB IM a - R — R XOR src 
IR te = - 
DA 9 10 12 
xX 10 10 13 
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Program Clock Cycles 
Control 


Mnemonics Operands Addr. Word, Byte Long Word Operation 
Modes wg 88 SE NS SS SL 


CALL dst IR 10 - 15 Call Subroutine 
DA Le 6er 20) Autodecrement SP 
xX is 18 Zi @ SP — PC 
PC — dst 
CALR dst RA 10 - 15 Call Relative 
Autodecrement SP 
@ SP — PC 
PC — PC + dst (range -4094 to +4096) 
DJNZ R, dst RA 11 - - Decrement and Jump if Non-Zero 
DBJNZ R-R-1 
If R #0: PC — PC + dst (range -254 to 0) 
IRET* - - 13 - 16 Interrupt Return 
PS — @ SP 
Autoincrement SP 
JP cc, dst IR 10 - 15 (taken) Jump Conditional 
IR 7 - 7 (not taken) If cc is true: PC — dst 
DA 7 8 10 
X 8 8 11 
JR cc, dst RA 6 - - Jump Conditional Relative 
If cc is true: PC — PC + dst 
(range -256 to +254) 
RET cc ~ 10 . 13 (taken) Return Conditional 
7 - 7 (not taken) If cc is true: PC — @ SP 
Autoincrement SP 
sc src IM 33 - 39 System Call 
Autodecrement SP 
@ SP — old PS 


Push instruction 
PS — System Call PS 


nn nn nn nn ee aattIEE dEUS SSSI SSDS 


Bit BIT dst, b R 4. - - Test Bit Static 
Manipula- BITB IR 8 - . Z flag — NOT dst bit specified by b 
fon DA LOR —itrels 
xX 1] 11] 14 
BIT dst, R R 10 - - Test Bit Dynamic 
BITB Z flag — NOT dst bit specified by 
contents of R 
RES dst, b R 4 - - Reset Bit Static 
RESB IR 11 - - Reset dst bit specified by b 
DA 13 14 16 
xX 14 14 17 
RES dst, R R 10 - = Reset Bit Dynamic 
RESB Reset dst bit specified by contents R 
SET dst, b R 4 - - Set Bit Static 
SETB IR 11 ~ = Set dst bit specified by b 
DA 13 14 16 
X 14 14 17 
SET dst, R R 10 - - Set Bit Dynamic 
SETB Set dst bit specified by contents of R 
TSET dst R 7. - - Test and Set 
TSETB IR 11] - ~ S flag — MSB of dst 
DA 14> TS,» dst — all Is 
xX 1S 15 18 


*Privileged instruction. Executed in system mode only. 
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Rotate Clock Cycles 


d 
ean Mnemonics Operands Addr. Word, Byte Long Word Operation 
Modes NS 68 §[ oNSMSS SL 
RLDB R, sre R oS = - Rotate Digit Left 
RRDB R, sre R a - Rotate Digit Right 
RL dst, n R 6forn = 1 Rotate Left 
RLB R Tforn = 2 by n bits (n = 1, 2) 
RLC i dst,n R 6forn = | Rotate Left through Carry 
RLCB R 7forn = 2 by n bits (n = 1, 2) 
RR dst,n R 6forn = 1 Rotate Right 
RRB R 7forn = 2 by n bits (n = 1, 2) 
RRC dst,n R 6forn = 1 Rotate Right through Carry 
RRCB R 7forn = 2 by n bits (n = 1, 2) 
SDA dst, R R (15 + 3n) (15 + 3n) Shift Dynamic Arithmetic 
SDAB Shift dst left or right 
SDAL by contents of R 
SDL dst, R R (15 + 3n) (15 + 3n) Shift Dynamic Logical 
SDLB Shift dst left or right 
SDLL by contents of R 
SLA dst,n R (13 + 3n) (13 +3 n) Shift Left Arithmetic 
SLAB by n bits 
SLAL 
SLL dst, n R (13 + 3n) (13 + 3n) Shift Left Logical 
SLLB by n bits 
SLLL 
SRA dst,n R (13 + 3n) (13 + 3n) Shift Right Arithmetic 
SRAB by n bits 
SRAL 
SRL dst,n R (13 + 3n) (13 + 3n) Shift Right Logical 
SRLB by n bits 
SRLL 
Block CPD Rx, sre, Ry, cc IR 20 - - Compare and Decrement 
Transfer CPDB Ry - sre 
and String Autodecrement src address 
Manipula- Ry — Ry - 1 
tion 
CPDR Rx, sre, Ry, cc IR (11 + 9n) Compare, Decrement and Repeat 
CPDRB Rx - sre 
Autodecrement src address 
Ry — Ry -1 
Repeat until cc is true or Ry = 0 
CPI Rx, sre, Ry, cc IR 20 - - Compare and Increment 
CPIB Rx - sre 
Autoincrement sre address 
Ry — Ry -1 
CPIR Ry, sre, Ry, cc IR (11 + 9n) Compare, Increment and Repeat 
CPIRB Rx - src 
Autoincrement src address 
Ry — Ry-1 
Repeat until cc is true or Ry = 0 
CPSD dst, src, R, cc IR 2 = - Compare String and Decrement 
CPSDB dst - sre 
Autodecrement dst and src addresses 
R-R-1 
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Block Transfer Clock Cycles 


and String Mnemonics Operands Addr. Word, Byte Long Word Operation 


be Modes’ ns ee 25,24 NS SS SL 
CPSDR dst, src, R, cc IR (11 + 14n) Compare String, Decr. and Repeat 
CPSDRB dst - src 
Autodecrement dst and src addresses 
R—-R-1 
Repeat until cc is true or R = 0 
CPSI dst, src, R, cc IR 25 - - Compare String and Increment 
CPSIB dst - sre 
Autoincrement dst and src addresses 
R-R-1 
CPSIR dst, src, R, cc IR (11 + 14n) Compare String, Incr. and Repeat 
CPSIRB dst - src 
Autoincrement dst and sre addresses 
R-R-1 
Repeat until cc is true or R = 0 
LDD dst, src, R IR 20 - - Load and Decrement 
LDDB dst — src 
Autodecrement dst and src addresses 
R-R-1 
LDDR dst, src,R IR (11 + 9n) Load, Decrement and Repeat 
LDDRB dst — src 
Autodecrement dst and src addresses 
R-R-1 
Repeat until R = 0 
LDI dst, src, R IR 20 - ~ Load and Increment 
LDIB dst — src 
Autoincrement dst and src addresses 
R-—R-1 
LDIR dst, src, R IR (11 + 9n) Load, Increment and Repeat 
LDIRB dst — src ‘ 
Autoincrement dst and src addresses 
R-—R-1 


Repeat until R = 0 


TRDB dst, src,R IR 25 - - Translate and Decrement 
dst — src (dst) 
Autodecrement dst address 
R-R-1 


TRDRB dst, src, R IR (11 + 14n) Translate, Decrement and Repeat 
dst — src (dst) 
Autodecrement dst address 
R-R-1 
Repeat until R = 0 


TRIB dst, src, R IR 25 - - Translate and Increment 
dst — src (dst) 
Autoincrement dst address 
R-R-1 


TRIRB dst, src,R IR (11 + 14n) Translate. Increment and Repeat 
dst — src (dst) 
Autoincrement dst address 
R-R-1 
Repeat until R = 0 


TRTDB srcl,src2,R IR 25 - - Translate and Test, Decrement 
RH1 = src 2 (src 1) 
Autodecrement src | address 
R-R-1 
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Block Transfer 
and String 


Clock Cycles 


Manipulation Mnemonics Operands Addr. Word, Byte Long Word Operation 
(Ganeanicd) Modes NS 1-88 )-SLoy NS°'SS SL 
TRTDRB srcl,src2,R IR (11 + 14 n) Translate and Test, Decr. and Repeat 
RH1 = src 2 (sre 1) 
Autodecrement src | address 
R-R-1 
Repeat until R = 0 or RH] = 0 
TRTIB srcl,src2,R IR 25 Translate and Test, Increment 
RH1 = src 2 (src 1) 
Autoincrement src | address 
R-R-1 
TRTIRB srcl,src2,R IR (11 + 14 n) Translate and Test, Incr. and Repeat 
RH1 — src 2 (src 1) 
Autoincrement src | address 
R-R-1 
Repeat until R = 0 or RH] = 0 
Input/ IN* R, src IR 10) =" = Input 
Output INB* DA 12. - - R = sre 
IND* dst, src, R IR 21 - = Input and Decrement 
INDB* dst — src 
Autodecrement dst address 
R-R-1 
INDR* dst, src, R IR (11 + 10n) Input, Decrement and Repeat 
INDRB* dst — src 
Autodecrement dst address 
R-R-1 
Repeat until R = 0 
INI* dst, src, R IR 21 - - Input and Increment 
INIB* dst — src 
Autoincrement dst address 
R-R-1 
INIR* dst, src, R IR (11 + 10n) Input, Increment and Repeat 
INIRB* dst — src 
Autoincrement dst address 
R-R-1 
Repeat until R = 0 
ouT* dst, R IR TO a he Output 
OUTB* DA iQ) = - dst — R 
OUTD* dst, src, R IR 21 - - Output and Decrement 
OUTDB* dst — src 
Autodecrement src address 
R-R-1 
OTDR* dst, src, R IR (11 + 10 n) Output. Decrement and Repeat 
OTDRB* dst — src 
Autodecrement src address 
R-R-1 
Repeat until R = 0 
OUTI* dst, src, R IR 21 = = Output and Increment 
OUTIB* dst — src 
Autoincrement src address 
R-R-1 
OTIR* dst, src, R IR (11 + 10 n) Output, Increment and Repeat 
OTIRB* dst — src 


*Privileged instructions. Executed in system mode only. 
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Autoincrement src address 
R-R-1 
Repeat until R = 0 


Input/Output Clock Cycles 
(Continued) 


Mnemonics Operands Addr. Word, Byte Long Word Operation 
Modes Ns .SS_SL., NS=9SS SL 


SIN* R, src DA 12 - - Special Input 
SINB* R = sre 
SIND* dst, src, R IR 21 - - Special Input and Decrement 
SINDB* dst — src 
Autodecrement dst address 
R-R-1 
SINDR* dst, src, R IR (11 + 10 n) Special Input, Decrement and Repeat 
SINDRB* dst — src 
Autodecrement dst address 
R-R-1 
Repeat until R = 0 
SINI* dst, src, R IR 21 - - Special Input and Increment 
SINIB* dst — sre 
Autoincrement dst address 
R-R-1 
SINIR* dst, src,R IR (11 + 10n) Special Input, Increment and Repeat 
SINIRB* dst — sre 
Autoincrement dst address 
R-R-1 
Repeat until R = 0 
SOUT* dst, src DA 12 - - Special Output 
SOUTB* dst — sre 
SOUTD* dst, src, R IR 21 - = Special Output and Decrement 
SOUTDB* dst — sre 
Autodecrement src address 
R-R-1 
SOTDR* dst, src, R IR (11 + 10n) Special Output. Decr. and Repeat 
SOTDRB* dst — sre 
Autodecrement sre address 
R-R-1 
Repeat until R = 0 
SOUTI* dst, src, R IR 21 - - Special Output and Increment 
SOUTIB* dst — src 
Autoincrement src address 
R-R-1 
SOTIR* dst, src, R R (11 + 10n) Special Output. Incr. and Repeat 
SOTIRB* dst — src 
Autoincrement src address 
R-R-1 


Repeat until R = 0 


SSS ee 


CPU COMFLG flags - wae - Complement Flag 
Control (Any combination of C, Z, S, P/V) 
DI* int - GY - Disable Interrupt 


(Any combination of NVI, VI) 


EX* int - 6 - - Enable Interrupt 
(Any combination of NVI, VI) 

HALT* - - (8 + 3n) HALT 

LDCTL* CTLR, sre R 7 - = Load into Control Register 
CTLR — sre 

LDCTL* dst, CTLR R a - - Load from Control Register 
dst — CTLR 


*Privileged instructions. Executed in system mode only. 
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CPU Clock Cycles 


ntrol 
eo ; Mnemonics Operands Addr. Word, Byte Long Word Operation 
(Continued) Mod. 
: <= NSMsS (SL NS SS SL 
LDCTLB FLGR, sre R 7 . - Load into Flag Byte Register 
FLGR = src 
LDCTLB dst, FLGR R 7 - - Load from Flag Byte Register 
dst — FLGR 
LDPS* src IR 12 - 16 Load Program Status 
DA 1G a0. eae PS = src 
xX 17 "20" "23 
MBIT* - - a - - Test Multi-Micro Bit 
Set S if M, is Low; reset S if M; is High. 
MREQ* dst R (12 + 7n) Multi-Micro Request 
MRES* - - 5 - - Multi-Micro Reset 
MSET* - - 5 - - Multi-Micro Set 
NOP - - 7 - - No Operation 
RESFLG flag - 7 - - Reset Flag 
(Any combination of C, Z, S, P/V) 
SETFLG flag - ME - - Set Flag 
(Any combination of C, Z, S, P/V) 
“Privileged instructions. Executed in system mode only. 
Condition Code . Meaning Flag Settings CC Field 
Gores Always false : 0000 
Always true - 1000 
Z Zero Zs) 0110 
NZ Not zero Z =10 1110 
Cc Carry C=] 0111 
NC No Carry e190 111] 
PL Plus 2 =o 1101 
MI Minus Seal 0101 
NE Not equal Z =0, 1110 
EQ Equal ye aN | 0110 
OV Overflow ey AN ee it 0100 
NOV No overflow P/V = 0 1100 
PE Parity is even Va | 0100 
PO Parity is odd PAV ="0) 1100 
GE Greater than or equal (signed) (S XOR P/V) = 0 1001 
LT Less than (signed) (S XOR P/V) = 1 0001 
GT Greater than (signed) ([Z OR (S XOR P/V)) = 0 1010 
LE Less than or equal (signed) (Z OR (S XOR P/V)] = 1 0010 
UGE Unsigned greater than or equal (esi) Li11 
ULT Unsigned less than (enti 0111 
UGT Unsigned greater than (C= 0) -AND(Z = 0))] = 1 1011 
ULE Unsigned less than or equal (Gi@R 2) =. 0011 
Note that some condition codes have identical flag settings and binary fields in the instruction: 
Z = EQ, NZ = NE, C = ULT, NC = UGE, OV = PE, NOV = PO 
Status ST3-STp Definition ST3-STg Definition 
Line 
Codes 0000 Internal operation 1000 Data memory request 
0001 Memory refresh 1001 Stack memory request 
0010 I/O reference 1010 Reserved 
0011 Special I/O reference (e.g., to an MMU) 1011 Reserved 
0100 Segment trap acknowledge 1100 Program reference, nth word 
0101 Non-maskable interrupt acknowledge 1 hon Instruction fetch, first word 
0110 Non-vectored interrupt acknowledge pa Lal (6) Reserved 
O11 11 Vectored interrupt acknowledge 1 Teed Reserved 
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Pin 
Description 


ADo-ADj)5. Address/Data (inputs/outputs, 
active High, 3-state). These multiplexed 
address and data lines are used both for I/O 
and to address memory. 


AS. Address Strobe (output, active Low, 
3-state). The rising edge of AS indicates 
addresses are valid. 


BUSAK. Bus Acknowledge (output, active 
Low). A Low on this line indicates the CPU has 
religuished control of the bus. 


BUSRQ. Bus Request (input, active Low). This 
line must be driven Low to request the bus 
from the CPU. 


DS. Data Strobe (output, active Low, 3-state). 
This line times the data in and out of the CPU. 


MREQ. Memory Request (output, active Low, 
3-state). A Low on this line indicates that the 
address/data bus hold a memory address. 


My. Mo. Multi-Micro In, Multi-Micro Out (in- 
put and output, active Low). These two lines 
form a resource-request daisy chain that allows 
one CPU in a multi-microprocessor system to 
access a shared resource. 


NMI. Non-Maskable Interrupt (edge triggered, 
input, active Low). A high-to-low transition on 
NMI requests a non-maskable interrupt. The 
NMI interrupt has the highest priority of the 
three types of interrupts. 


NVI. Non-Vectored Interrupt (input, active 
Low). A Low on this line requests a non- 
vectored interrupt. 


Figure 8. Z8001 Pin Assignments 


CLK. System Clock (input). CLK is a 5V 
single-phase time-base input. 


RESET. Reset (input, active Low). A Low on 
this line resets the CPU. 


R/W. Read/Write (output, Low = Write, 
3-state). R/W indicates that the CPU is reading 
from or writing to memory or I/O. 


SNo-SNg. Segment Number (outputs, active 

High, 3-state). These lines provide the 7-bit 

segment number used to address one of 128 

segments by the Z8010 Memory Management 
Unit. Output by the Z8001 only. 


SEGT. Segment Trap (input, active Low). The 
Memory Management Unit interrupts the CPU 
with a Low on this line when the MMU detects 
a segmentation trap. 


STo-ST 3. Status (outputs, active High, 3-state). 
These lines specify the CPU status (see table). 


STOP. Stop (input, active Low). This input can 
be used to single-step instruction execution. 


VI. Vectored Interrupt (input, active Low). A 
Low on this line requests a vectored interrupt. 


WAIT. Wait (input, active Low). This line indi- 
cates to the CPU that the memory or I/O 
device is not ready for data transfer. 


B/W. Byte/Word (output, Low = Word, 
3-state). This signal defines the type of memory 
reference on the 16-bit address/data bus. 


N/S. Normal/System Mode (output, Low = 
System Mode, 3-state). N/S indicates the CPU 
is in the normal or system mode. 


Decouple. Output from on-chip negative sub- 
strate-bias generator. Presently not connected. 


ADo 
ADs 
AD, 
ADs 
AD, 
ADs 
AD3 
AD2 
AD, 
GND 
CLOCK 
AS 
DECOUPLE 
BW 


Figure 9. Z8002 Pin Assignments 
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Z8000 
CPU 
Timing 


The Z8000 CPU executes instructions by 
stepping through sequences of basic machine 
cycles, such as memory read or write, I/O 
device read or write, interrupt acknowledge 
and internal execution. Each of these basic 
cycles require three to ten clock cycles to 
execute. Instructions that require more clock 
cycles to execute are broken up into several 
machine cycles. Thus no machine cycle is 
longer than ten clock cycles and fast response 
to a Bus Request is guaranteed. 

The instruction opcode is fetched by a 
normal memory read operation. A memory 
refresh cycle can be inserted just after the 
completion of any first instruction fetch (IF)) 


cycle and can also be inserted while the 
following instructions are being executed: 
MULT, MULITL, DIV, DIVL, HALT, all Shift 
instructions, all Block Move instructions, and 
the Multi-Micro Request instruction (MREQ). 

The following timing diagrams show the 
relative timing relationships of all CPU signals 
during each of the basic operations. When a 
machine cycle requires additional clock cycles 
for CPU internal operation, one to five clock 
cycles are added. Memory and I/O read and 
write, as well as interrupt acknowledge cycles, 
can be extended by activating the WAIT input. 
For exact timing information, refer to the com- 
posite timing diagram. 


Memory 
Read and 
Write 
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Memory read and instruction fetch cycles 
are identical, except for the status information 
on the STo-ST3 outputs. During a memory 
read cycle, a 16-bit address is placed on the 
ADo-ADjs outputs early in the first clock 


period, as shown in Figure 10. (In the Z8001, 
the 7-bit segment number is output on 
SNo-SNg one clock period earlier than the 
16-bit address offset to compensate for the 
delay in the memory management circuitry.) 
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Figure 10. Memory Read and Write Timing 


Memory 
Read and 
Write 
(Continued) 


Input/ 
Output 


A valid address is indicated by the rising 
edge of Address Strobe. Status and mode 
information become valid early in the memory 
access cycle and remain stable throughout. 
The state of the WAIT input is sampled in the 
middle of the second clock cycle by the falling 
edge of Clock. If WAIT is Low, an additional 
clock period is added between T2 and T3. 
WAIT is sampled again in the middle of this 
wait cycle, and additional wait states can be 
inserted. This allows interfacing slow 


I/O timing is similar to memory read/write 
timing, except that one wait state is automat- 
ically inserted between Tz and T3 (Figure 11). 


CLOCK 


STATUSES 
(B/W, STo-STs) 


AS 


memories. No control outputs change during 
wait states. 

Although Z8000 memory is word organized, 
memory is addressed as bytes. All instructions 
are word-aligned, using even addresses. 
Within a 16-bit word, the most significant byte 
(Dg-Dj5) is addressed by the low-order address 
(Ao = Low), and the least significant byte 
(Do-D7) is addressed by the high-order 
address (Ap = High). 


Both the segmented Z8001 and the non- 
segmented Z8002 use 16-bit I/O addresses. 
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Figure 11. Input/Output Timing 
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Interrupt and 
Segment 
Trap Request 
and 
Acknowledge 


INTERNAL 
WMI 


The Z8000 CPU recognizes three interrupt 
inputs (non-maskable, vectored and non- 
vectored) and a segmentation trap input. Any 
High-to-Low transition on the NMI input is 
asynchronously edge detected and sets the 
internal NMI latch. The VI, NVI and 
SEGT inputs as well as the state of the internal 
NMI latch are sampled at the beginning of T3 
in the last machine cycle of any instruction. 

In response to an interrupt or trap, the sub- 
sequent IF) cycle is exercised, but aborted. 
The program counter is not updated, but the 
system stack pointer iv decremented. 

The next machine cycle is the interrupt 
acknowledge cycle. This cycle has five 
automatic wait states, with additional wait 


states possible, as shown in Figure 12. 

After the last wait state, the CPU reads the 
information on ADo-ADjs and stores it tem- 
porarily, to be saved on the stack later in the 
acknowledge sequence. This word identifies 
the source of the interrupt or trap. For the 
non-vectored and non-maskable interrupts, all 
16 bits can represent peripheral device status 
information. For the vectored interrupt, the 
low byte is the jump vector, and the high byte 
can be extra user status. For the segmentation 
trap, the high byte is the Memory Management 
Unit identifier and the /ow byte is undefined. 

After the acknowledge cycle, the N/S output 
indicates the automatic change to system 
mode. 


LAST MACHINE INSTRUCTION 
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Figure 12. Interrupt and Segment Trap Request/Acknowledge Timing 


Status 
Saving 
Sequence 


The machine cycles following the interrupt 
acknowledge or segmentation trap acknow- 
ledge cycle push the old status information on 
the system stack in the following order: the 
16-bit program counter; the 7-bit segment 
number (Z8001 only); the flag and control 


word; and finally the interrupt/trap identifier. 
Subsequent machine cycles fetch the new pro- 
gram status from the program status area, and 
then branch to the interrupt/trap service 
routine. 


a 


Bus Request 
Acknowledge 
Timing 
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A Low on the BUSRO input indicates to the 
CPU that another device is requesting the 
Address/Data and Control buses. The asyn- 
chronous BUSRO input is synchronized at the 
beginning of any machine cycle (Figure 13). If 


BUSROQ is Low, an internal synchronous 
BUSRO signal is generated, which-after com- 
pletion of the current machine cycle-causes 
the BUSAK output to go Low and all bus out- 
puts to go into the high-impedance state. The 


STATUS 
SAVING 


Bus Request/ requesting device-typically a DMA-can then put goes High one clock period later, indicat- 
Acknowledge control all buses. ing that the CPU will again take control of the 
(Continued) When BUSROQ is released, it is synchronized bus. 

with the rising clock edge and the BUSAK out- 
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Figure 13. Bus Request/Acknowledge Timing 


Stop The STOP input is sampled by the last falling refresh prescaler or its divide-by-four clock 
clock edge immediately preceding any IF, prescaler; rather, it double-increments the 
cycle (Figure 14). If STOP is found Low, a refresh counter every three clock cycles. 
stream of memory refresh cycles is inserted When STOP is found High again, the next 
after T3, again sampling the STOP input on refresh cycle is completed, any remaining T 
each falling clock edge in the middle of the T3 states of the IF; cycle are then executed and 
states. This refresh operation does not use the the CPU continues its operation. 
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Figure 14. Stop Timing 


573 


Internal 
Operation 


Certain extended instructions such as 
Multiply and Divide, and some special instruc- 
tions need additional time for the execution of 
internal operations. In these cases, the CPU 
goes through a sequence of internal operation 
machine cycles, each of which is three to eight 
clock cycles long (Figure 15). This allows fast 
response to Bus Request and Refresh Request, 


because bus request or refresh cycles can be 
inserted at the end of any internal machine 
cycle. 

Although the address outputs during T) are 
undefined, Address Strobe is generated to 
satisfy the requirements of future Z-Bus com- 
patible self-refresh dynamic memories. 


CLOCK 


STo-ST3 


MREQ, DS, RW 
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Figure 15. Internal Operation Timing 


Memory 
Refresh 
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When the 6-bit prescaler in the refresh 
counter has been decremented to zero, a 
refresh cycle consisting of three T-states is 
started as soon as possible (that is, after the 
next IF; cycle or Internal Operation cycle). 

The 9-bit refresh counter value is put on the 
low-order side of the address bus (ADg-ADs); 
ADg-ADjs are undefined (Figure 16). Since 
the memory is word-organized, Ag is always 
Low during refresh and the refresh counter is 


cLocK 


wait 


STo-STs 


AD 


SAME AS PREVIOUS CYCLE 


always incremented by two, thus stepping 
through 256 consecutive refresh addresses on 
AD ,-ADg. Unless disabled, the presettable 
prescaler runs continuously and the delay in 
starting a refresh cycle is therefore not 
cumulative. 

While the STOP input is Low, a continuous 
stream of memory refresh cycles, each three 
T-states long, is executed without using the 
refresh prescaler. 


Figure 16. Memory Refresh Timing 


Halt 


Reset 


A HALT instruction executes an unlimited 
number of 3-cycle internal operations, 
inter-spersed with memory refresh cycles 
whenever requested. An interrupt, segmenta- 
tion trap or reset are the only exits from a 
HALT instruction. 


A Low on the RESET input causes the follow- 


ing results within five clock cycles or less 
(Figure 17): 


O ADo-ADjs are 3-stated 


4 AS, DS, MREQ, 
BUSAK and Mo are forced High 


Li STg-ST3 and SNo-SN¢ are forced Low 

Li Refresh is disabled ! 

CO R/W, B/W and N/S are not affected 

When RESET has been High for three clock 


The CPU samples the VI, NVI, NMI and 
SEGT inputs at the beginning of every T3 
cycle. If an input is found active during two 
consecutive samples, the subsequent IF) cycle 
is exercised, but aborted, and the normal 
interrupt acknowledge cycle is started. 


periods, two consecutive memory read cycles 
are executed in the system mode. In the Z8001, 
the first cycle reads the flag and control word 
from location 0002, the next reads the 7-bit 
program counter segment number from loca- 
tion 0004, the next reads the 16-bit PC offset 
from location 0006, and the following IF) cycle 
starts the program. In the Z8002, the first cycle 
reads the flag and control word from location 
0002, the next reads the PC from location 0004 
and the following IF) cycle starts the program. 


Figure 17. Reset Timing 
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This composite timing dia- 
gram does not show actual 
timing sequences. Refer to 
this diagram only for the 
detailed timing relationships 
of individual edges. Use the 
preceding illustrations as an 
explanation of the various 
timing sequences. 


Timing measurements are 
made at the following 


voltages 

High Low 
Clock 4.0V 0.8V 
Output 2.0V 0.8V 
Input 2.0V 0.8V 
Float AV +0.5V 


AC 
Electrical 
Characteristics 


Number Symbol Parameter Min Max Unit 
1 TceC Clock Cycle Time 250 2000 ns 
2 TwCh Clock Width (High) 105 2000 ns 
Ss TwCl Clock Width (Low) 105 2000 ns 
4 bie Clock Fall Time 20 ns 
—s TrC t———— Clock Rise Time 20 ——— ns — 
6 TdC(SNv) Clock 1 to Segment Number Valid (50 pF load) 130 ns 
7 TdC(SNn) Clock 1 to Segment Number Not Valid 20 ns 
8 TdC(Bz) Clock 1 to Bus Float 65 ns 
9 TdC(A) Clock 1 to Address Valid 100 ns 
= 10————- Td G (Az) Clock | to Address Float 65 ——— ns —— 
11 TdA(DI) Address Valid to Data In Required Valid 400 ns 
12 TsDI(C) Data In to Clock ! Setup Time 70 ns 
13 TdDS(A) DS | to Address Active 80 ns 
14 TdC(DO) Clock t to Data Out Valid 100 ns 
— 15—— ThDI(DS) Data In to DS 1 Hold Time 0 ns —— 
16 TdDO(DS) Data Out Valid to DS | Delay 230 ns 
We TdA(MR) Address Valid to MREQ ! Delay 55 ns 
18 TdC(MR) Clock | to MREQ ! Delay 80 ns 
19 TwMRh MREQ Width (High) 190 ns 
— 20 —— TdMR(A) —— MREQ | to Address Not Active 70 ns —— 
21 TdDO(DSW) Data Out Valid to DS | (Write) Delay 55 ns 
22 TdMR(DI) MREO | to Data In Required Valid 33053 ns 
23 TdC(MR) Clock | to MREQ 1 Delay : 80 ns 
24 TdC(AS#) Clock 1 to AS | Delay 80 ns 
— 25 TdA(AS) ——— Address Valid to AS ! Delay 55 ns —— 
26 TdC(ASr) Clock | to AS 1 Delay 90 ns 
27 TdAS(DI) AS | to Data In Required Valid 290 ns 
28 TdDS(AS) DS | to AS | Delay 70 ns 
29 TwAS AS Width (Low) 80 ns 
— 30 —— TdAS(A) ——— AS | to Address Not Active Delay 60 ns —— 
31 TdAz(DSR) Address Float to DS (Read) ! Delay 0 ns 
32 TdAS(DSR) AS t to DS (Read) ! Delay 70 ns 
ag TdDSR(DI) DS (Read) | to Data In Required Valid 155 ns 
34 TdC(DSr) Clock | to DS 1 Delay 70 ns 
— 35 —— TdDS(DO) —— DS 1 to Data Out and STATUS Not Valid 80 ns —— 
36 TdA(DSR) Address Valid to DS (Read) | Delay 120 ns 
37 TdC(DSR) Clock 1 to DS (Read) | Delay 120 ns 
38 TwDSR DS (Read) Width (Low) 275 ns 
39 TdC(DSW) Clock ! to DS (Write) | Delay 95 ns 
—40— TwDSW DS (Write) Width (Low) 160 ns —— 
4] TdDSI(DI) DS (Input) | to Data In Required Valid 315 ns 
42 TdC(DSf) Clock | to DS (I/O) | Delay 120 ns 
43 TwDS DS (I/O) Width (Low) 400 ns 
44 TdAS(DSA) AS | to DS (Acknowledge) ! Delay 960 ns 
— 45—— TdC(DSA)—— Clock 1 to DS (Acknowledge) ! Delay 120 ns —— 
46 TdDSA(DI) DS (Ack.) | to Data In Required Delay 420 ns 
47 TdC(S) Clock | to Status Valid Delay 110 ns 
48 TdS(AS) Status Valid to AS 1 Delay 40 ns 
49 TsR(C) RESET to Clock 1! Setup Time 180 ns 
50 ThR(C) RESET to Clock | Hold Time 0 ns 
51 TwNMI NMI Width (Low) 100 ns 
oe. TsNMI(C) NMI to Clock 1 Setup Time 140 ns 
53 TsVI(C) VI, NVI to Clock | Setup Time 110 ns 
54 ThVI(C) VI, NVI to Clock | Hold Time 0 ns 
=55 TsSGT(C) —— SEGT to Clock t Setup Time 70 ns 
56 ThSGT(C) SEGT to Clock | Hold Time 0 ns 
57 TsMi(C) Mi to Clock 1 Setup Time 180 ns 
58 ThMi(C) MI to Clock 1 Hold Time 0 ns 
59 TdC(Mo) Clock | to Mo Delay 120 ns 
—60 TsSTP(C) ——— STOP to Clock | Setup Time 140 ns— 
61 ThSTP(C) STOP to Clock |! Hold Time 0 ns 
62 TsWT(C) WAIT to Clock ! Setup Time 70 ns 
63 ThWT(C) WAIT to Clock ! Hold Time 0 ns 
64 TsBRQ(C) BUSROQ to Clock ft Setup Time 90 ns 
— 65 —— ThBRQ(C)—— BUSRO to Clock t Hold Time re) ns 
66 TdC(BAKr) Clock | to BUSAK | Delay 100 ns 
67 TdC(BAKf) Clock t to BUSAK | Delay 100 ns 


Absolute Voltages on all inputs and outputs Stresses greater than those listed under Absolute Maxi- 
Maximum with respect to GND -0.3Vto +7.0V mum Ratings may cause permanent damage to the device. 
Hees Ue ee é i This is a stress rating only; operation of the device at any 
atings Operating Ambient condition above those indicated in the operational sections 
Memperatune step etete es canis 0°C to +70°C of these specifications is not implied. Exposure to absolute 
; : maximum rating conditions for extended periods may affect 
Storage Temperature........ -65°C to +150°C device reliability. 
Standard The characteristics below apply for the Vee 
Test following standard test conditions, unless 
Conditions otherwise noted. All voltages are referenced to 5 
GND. Positive current flows into the refer- Pome 
enced pin. Standard conditions are as follows: a 290 
+4.75V < Voc S +5.25 V I Me ak 
O GND =0V All ac parameters assume a load capacitance of 100 pF max, ex- 
cept for parameter 6 (50 pF max). Timing references between two 
o°c < Ty = 20°C output signals assume a load difference of 50 pF max. 
DC Symbol Parameter Min Max Unit Condition 
si al Vou Clock Input High Voltage Vec-0.4 Vcec+0.3 Vv Driven by External Clock Generator 
ic: 
VoL Clock Input Low Voltage -0.3 0.45 V Driven by External Clock Generator 
Vin Input High Voltage 2.0 Voc +0.3 Vv 
Vit Input Low Voltage -0.3 0.8 Vv 
Vou Output High Voltage 2.4 V Ion = -250 pA 
VoL Output Low Voltage 0.4 Vv Io, = +2.0mA 
I Input Leakage +10 pA 0.4 < Vin s +2.4V 
Io. Output Leakage +10 pA 0.4 <= Vout = +2.4V 
Iec Vec Supply Current 300 mA 
Ordering Temperature Number init 
Part Number ‘ Package Description 
Information Range of Pins 4 i 
Z8001 CPU 0°C to +70°C 48 Ceramic Segmented 16-Bit Microprocessor 
Z8002 CPU 0°C to +70°C 40 Ceramic Non-Segmented 16-Bit Microprocessor 
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Package 
Information 


0.185 0.095 


0.600 0.125 |__ 0.065 POTHIENDS fe |__ otto ail |__ 0.021 
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40-Pin Ceramic Package (Z8002) 


2.425 
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48-Pin Ceramic Package (Z8001) 
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Z8010 MMU Memory 
Management Unit 


Product 
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as it Ss 
Zilog Specification 
Preliminary 
Features m Dynamic segment relocation makes software 65,536 bytes can be mapped into a total 
addresses independent of physical memory physical address space of 16 megabytes; all 
addresses. 64 segments are randomly accessible. 
@ Sophisticated memory-management features w Multiple MMUs can support several transla- 
include access validation that protects tion tables for each Z8001 address space. 
Mem On aereee from unauthorized OF me @ MMU architecture supports multi-program- 
unintentional access, and a write-warning ming systems and virtual memory implemen- 
indicator that predicts stack overflow. iationee 
m 64 variable-sized segments from 256 to 
General The Z8010 Memory Management Unit (MMU) located in the physical memory. It also pro- 
Description manages the large 8M byte addressing spaces vides a flexible, efficient method for support- 


of the Z8001 CPU. The MMU provides dynamic 
segment relocation as well as numerous 
memory protection features. 

Dynamic segment relocation makes user soft- 
ware addresses independent of the physical 
memory addresses, thereby freeing the user 
from specifying where information is actually 
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Figure 1. Pin Functions 


ing multi-programming systems. The MMU 
uses a translation table to transform the 23-bit 
logical address output from the Z8001 CPU 
into a 24-bit address for the physical memory. 
(Only logical memory addresses go to an MMU 
for translation; I/O addresses and data, in 
general, must bypass this component.) 
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Figure 2. Pin Assignments 
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General 
Description 
(Continued) 
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Memory segments are variable in size from 
256 bytes to 64 kilobytes, in increments of 256 
bytes. Pairs of MMUs support the 128 segment 
numbers available for the various Z8001 CPU 
address spaces. Within an address space, any 
number of MMUs can be used to accommodate 
multiple translation tables for System and Nor- 
mal operating modes, or to support more 
sophisticated memory-management systems. 

MMU memory-protection features safeguard 
memory areas from unauthorized or unin- 
tended access by associating special access 
restrictions with each segment. A segment is 
assigned a number of attributes when its 
descriptor initially entered into the MMU. 
When a memory reference is made, these 
attributes are checked against the status infor- 
mation supplied by the Z8001 CPU. If a 


‘SNo-SNg 


ADg-ADi5, 


INTERNAL DATA BUS 


— 


OFFSET BUS 


VIOLATION 
CHECKING 


mismatch occurs, a trap is generated and the 
CPU is interrupted. The CPU can then check 
the status registers of the MMU to determine 
the cause. 

Segments are protected by modes of permit- 
ted use, such as read only, system only, 
execute only and CPU-access only. Other seg- 
ment management features include a write- 
warning zone useful for stack operations and 
status flags that record read or write accesses 
to each segment. , 

The MMU is controlled via 22 Special I/O 
instructions from the Z8001 CPU in System 
mode. With these instructions, system software 
can assign program segments to arbitrary 
memory locations, restrict the use of segments 
and monitor whether segments have been read 
or written. 


SNo-SNo ADs-ADis 


INTERNAL DATA BUS 


STo-St3 SEGT SUP As-Az3 
RIW, NIS 


Figure 3. The shaded areas in these block diagrams illustrate the resources used in the two modes of MMU operation. In 
the Address Translation Mode shown on the left, addresses are translated automatically. In the Command Mode shown 
on the right, specific registers are accessed using Special I/O commands. 


Segmented 
Addressing 


A segmented addressing space—compared 
with linear addressing—is closer to the way a 
programmer uses memory because each pro- 
cedure and data set can reside in its own 
segment. 

The 8M byte Z8001 addressing spaces are 
divided into 128 relocatable segments of up to 
64K bytes each. A 23-bit segmented address 
uses a 7-bit segment address to point to the 
segment, and a 16-bit offset to address any 
byte relative to the beginning of the segment. 
The two parts of the segmented address may 
be manipulated separately. 

The MMU divides the physical memory into 
256-byte blocks. Segments consist of physically 
contiguous blocks. Certain segments may be 
designated so that writes into the last block 
generate a warning trap. If such a segment is 
used as a stack, this warning can be used to 
increase the segment size and prevent a stack 
overflow error. 

The addresses manipulated by the program- 
mer, used by instructions and output by the 
Z8001 are called logical addresses. The MMU 
takes the logical addresses and transforms 
them into the physical addresses required for 
accessing the memory (Figure 4). This address 
transformation process is called relocation. 

The relocation process is transparent to user 
software. A translation table in the MMU 
associates the 7-bit segment number with the 
base address of the physical memory segment. 


The 16-bit logical address offset is added to the 
physical base address to obtain the actual 
physical memory location. Because a base 
address always has a low byte equal to zero, 
only the high-order 16 bits are stored in the 
MMU and used in the addition. Thus the low- 
order byte of the physical memory location is 
the same as the low-order byte of the logical 
address offset. This low-order byte therefore 
bypasses the MMU, thus reducing the number 
of pins required. 


23-BIT LOGICAL ADDRESS 
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24-BIT PHYSICAL ADDRESS 


Figure 4. Logical-to-Physical Address Translation 


Memory 
Protection 


Each memory segment is assigned several 
attributes that are used to provide memory 
access protection. A memory request from the 
Z8001 CPU is accompanied by status informa- 
tion that indicates the attributes of the memory 
request. The MMU compares the memory 
request attributes with the segment attributes 
and generates a Trap Request whenever it 
detects an attribute violation. Trap Request 
informs the Z8001 CPU and the system control 
program of the violation so that appropriate 
action can be taken to recover. The MMU also 
generates the Suppress signal SUP in the 
event of an access violation. Suppress can be 
used by a memory system to inhibit stores into 
the memory and thus protect the contents of 
the memory from erroneous changes. 

Five attributes can be associated with each 
segment. When an attempted access violates 
any one of the attributes associated with a seg- 
ment, a Trap Request and a Suppress signal 
are generated by the MMU. These attributes 
are read only, execute only, system access 
only, inhibit CPU accesses and inhibit DMA 
accesses. 

Segments are specified by a base address 


and a range of legal offsets to this base 
address. On each access to a segment, the off- 
set is checked against this range to insure that 
the access falls within the allowed range. If an 
access that lies outside the segment is attemp- 
ted, Trap Request and Suppress are generated. 

Normally the legal range of offsets within a 
segment is from 0 to 256N + 255 bytes, where 
0<N<255. However, a segment may be 
specified so that legal offsets range from 256N 
to 65,535 bytes, where OS N<255. The latter 
type of segment is useful for stacks since the 
Z8001 stack manipulation instructions cause 
stacks to grow toward lower memory locations. 
Thus when a stack grows to the limit of its 
allocated segment, additional memory can be 
allocated on the correct end of the segment. 
As an aid in maintaining stacks, the MMU 
detects when a write is performed to the lowest 
allocated 256 bytes of these segments and 
generates a Trap Request. No Suppress signal 
is generated so the write is allowed to proceed. 
This write warning can then be used to indi- 
cate that more memory should be allocated to 
the segment. 
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The MMU contains three types of registers: 
Segment Descriptor, Control and Status. A 
set of 64 Segment Descriptor Registers supplies 
the information needed to map logical memory 
addresses to physical memory locations. The 
segment number of a logical address deter- 
mines which Segment Descriptor Register is 
used in address translation. Each Descriptor 
Register also contains the necessary informa- 
tion for checking that the segment location 
referenced is within the bounds of the segment 
and that the type of reference is permitted. It 
also indicates whether the segment has been 
read or written. 

In addition to the Segment Descriptor 
Registers, the Z8010 MMU contains three 8-bit 
control registers for programming the device 
and six 8-bit status registers that record infor- 
mation in the event of an access violation. 


Segment Descriptor Registers. Each of the 64 
Descriptor Registers contains a 16-bit base 
address field, an 8-bit limit field and an 8-bit 
attribute field (Figure 5). The base address 
field is subdivided into high- and low-order 
bytes that are loaded one byte at a time when 
the descriptor is initialized. The limit field con- 
tains a value N that indicates N+1 blocks of 
256 bytes have been allocated to the segment. * 
The attribute field contains eight flags 
(Figure 6). Five are related to protecting the 
segment against certain types of access, one 
indicates the special structure of the segment, 
and two encode the types of accesses that have 
been made to the segment. A flag is set when 
its value is 1. The following brief descriptions 
indicate how these flags are used. 
Read-Only (RD). When this flag is set, the segment is read 
only and is protected against any write access. 


System-Only (SYS). When this flag is set, the segment can 
be accessed only in system mode, and is protected against 
any access in normal mode. 


CPU-Inhibit (CPUI). When this flag is set, the segment is 
not accessible to the currently executing process, and is 
protected against any memory access by the CPU. The 
segment is, however, accessable under DMA. 


Execute-Only (EXC). When this flag is set, the segment 
can be accessed only during an instruction fetch cycle, and 
thus is protected against any access during other cycles. 


DMA-Inhibit (DMAI). When this flag is set, the segment 
can be accessed only by the CPU, and thus is protected 
against any access under DMA. 


Direction and Warning (DIRW). When this flag is set, the 
segment memory locations are considered to be organized 
in descending order and each write to the segment is 
checked for access to the last 256-byte block. Such an 
access generates a trap to warn of potential segment 
overflow, but no Suppress signal is generated. 


Changed (CHG). When this flag is set, the segment has 
been changed (written). This bit is set automatically during 
any write access to this segment if the write access does not 
cause any violation. 


Referenced (REF). When this flag is set, the segment has 
been referenced (either read or written). This bit is set 
automatically during any access to the segment if the 
access does not cause a violation. 


*In the stack mode, segment size is 64K-256N. 
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Figure 5. Segment Descriptor Registers 
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Figure 6. Attribute Field in Segment Descriptor Register 


Control Registers. The three user-accessible 
8-bit control registers in the MMU direct the 
functioning of the MMU (Figure 7). The Mode 
Register provides a sophisticated method for 
selectively enabling MMUs in multiple-MMU 
configurations. The Segment Address Register 
(SAR) selects a particular Segment Descriptor 
Register to be accessed during a control 
operation. The Descriptor Selection Counter 
Register points to a byte within the Segment 
Descriptor Register to be accessed during a 
control operation. 


MODE 
SEGMENT 
DESCRIPTOR 
ADDRESS 


DESCRIPTOR 
SELECTION 
COUNTER 


Figure 7. Control Registers 


The Mode Register contains a 3-bit iden- 
tification field (ID) that distinguishes among 
eight enabled MMUs in a multiple-MMU con- 
figuration. This field is used during the seg- 
ment trap acknowledge sequence (refer to the 
section on Segment Trap and Acknowledge). 
In addition, the Mode Register contains five 
flags. 

Multiple Segment Table (MST). This flag indicates whether 
multiple segment tables are present in the hardware con- 
figuration. When this flag is set, more than one table is 


present and the N/S line must be used to determine 
whether the MMU contains the appropriate table. 


Normal Mode Select (NMS). This flag indicates whether 
the MMU is to translate addresses when the N/S line is 
High or Low. If the MST flag is set, the N/S line must 
match the NMS flag for the MMU to translate segment 
addresses, otherwise the MMU Address lines remain 
3-stated. 


MMU 
Register 
Organization 
(Continued) 


Upper Range Select (URS). This flag is used to indicate 
whether the MMU contains the lower-numbered segment 
descriptors or the higher-numbered segment descriptors. 
The most significant bit of the segment number must match 
the URS flag for the MMU to translate segment addresses, 
otherwise the MMU Address lines remain 3-stated. 


Translate (TRNS). This flag indicates whether the MMU is 
to translate logical program addresses to physical memory 
locations or is to pass the logical addresses unchanged to 
the memory and without protection checking. In the non- 
translation mode, the most significant byte of the output is 
the 7-bit segment number and the most significant bit is 0. 
When this flag is set, the MMU performs addréss transla- 
tion and attribute checking. 


Master Enable (MSEN). This flag enables or disables the 
MMU from performing its address translation and memory 
protection functions. When this flag is set, the MMU per- 
forms these tasks; when the flag is clear the Address lines 
of the MMU remain 3-stated. 


The Segment Address Register (SAR) points 
to one of the 64 segment descriptors. Control 
commands to the MMU that access segment 
descriptors implicitly use this pointer to select 
one of the descriptors. This register has an 
auto-incrementing capability so that multiple 
descriptors can be accessed in a block 
read/write fashion. 

The Descriptor Selection Counter Register 
holds a 2-bit counter that indicates which byte 
in the descriptor is being accessed during the 
reading or writing operation. A value of zero 
in this counter indicates the high-order byte of 
the base address field is to be accessed, one 
indicates the low-order byte of the base 
address, two indicates the limit field and three 
indicates the attribute field. 


Status Registers. Six 8-bit registers contain 
information useful in recovering from memory 
access violations (Figure 8). The Violation 
Type Register describes the conditions that 
generated the trap. The Violation Segment 
Number and Violation Offset Registers record 
the most-significant 15 bits of the logical 
address that causes a trap. The Instruction 
Segment Number and Offset Registers record 
the most-significant 15 bits of the logical 
address of the last instruction fetched before 
the first accessing violation. These two 
registers can be used in conjunction with 
external circuitry that records the low-order 
offset byte. At the time of the addressing viola- 
tion, the Bus Cycle Status Register records the 
bus cycle status (status code, read/write mode 
and normal/system mode). 

The MMU generates a Trap Request for two 
general reasons: either it detects an access 


violation, such as an attempt to write into a 
read-only segment, or it detects a warning 
condition, which is a write into the lowest 256 
bytes of a segment with the DIRW flag set. 
When a violation or warning condition is 
detected, the MMU generates a Trap Request 
and automatically sets the appropriate flags. 
The eight flags in the Violation Type Register 
describe the cause of a trap. 


Read-Only Violation (RDV). Set when the CPU attempts to 
access a read-only segment and the R/W line is Low. 


System Violation (SYSV). Set when the CPU accesses a 
system-only segment and the N/S line is High. 


CPU-Inhibit Violation (CPUIV). Set when the CPU 
attempts to access a segment with the CPU-inhibit flag set. 


Execute-Only Violation (EXCV). Set when the CPU 
attempts to access an execute-only segment in other than 
an instruction fetch cycle. 


Segment Length Violation (SLV). Set when an offset falls 
outside of the legal range of a segment. 


Primary Write Warning (PWW). Set when an access is 
made to the lowest 256 bytes of a segment with the DIRW 
flag set. 


Secondary Write Warning (SWW). Set when the CPU 
pushes data into the last 256 bytes of a system stack and 
EXCV, CPUIV, SLV, SYSV, RDV or PWW is set. Once this 
flag is set, subsequent write warnings for accessing the 
system stack do not generate a Segment Trap request. 


Fatal Condition (FATL). Set when any other flag in the 
Violation Type Register is set and either a violation is 
detected or a write warning condition occurs in normal 
mode. This flag is not set during a stack push in system 
mode that results in a warning condition. This flag 
indicates a memory access error has occurred in the trap 
processing routine. Once set, no Trap Request signals are 
generated on subsequent violations. However, Suppress 
signals are generated on this and subsequent CPU viola- 
tions until the FATL flag has been reset. 
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Figure 8. Status Registers 
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Segment 
Trap and 
Acknowledge 


The Z8010 MMU generates a Segment Trap 
when it detects an access violation or a 
write warning condition. In the case of an 
access violation, the MMU also activates Sup- 
press, which can be used to inhibit memory 
writes and to flag special data to be returned 
on a read access. Segment Trap remains Low 
until a Trap Acknowledge signal is received. If 
a CPU-generated violation occurs, Suppress is 
asserted for that cycle and all subsequent CPU 
instruction execution cycles until the end of 
the instruction. Intervening DMA cycles are 
not suppressed, however, unless they generate 
a violation. Violations detected during DMA 
cycles cause Suppress to be asserted during 
that cycle only—no Segment Trap Requests are 
ever generated during DMA cycles. 

Segment traps to the Z8001 CPU are han- 
dled similarly to other types of interrupts. To 
service a segment trap, the CPU issues a seg- 
ment trap acknowledge cycle. The acknow- 
ledge cycle is always preceded by an instruc- 
tion fetch cycle that is aborted (the MMU has 
been designed so that this dummy cycle is 
ignored). During the acknowledge cycle all 
enabled MMUs use the Address/Data lines to 
indicate their status. An MMU that has 
generated a Segment Trap Request outputs a 1 
on the A/D line associated with the number in 
its ID field; an MMU that has not generated a 
segment trap request outputs a O on its 
associated A/D line. A/D lines for which no 
MMU is associated remain 3-stated. During a 


Several features of the MMU can be used in 
conjunction with external circuitry to support 
virtual memory for the Z8001. Segment Trap 
Request can be used to signal the CPU in the 
event that a segment is not in primary memory. 
The CPU-Inhibit Flag can be used to indicate 
whether a segment is in the memory or in 


segment trap acknowledge cycle, an MMU 
uses A/D line 8 +i if its ID field is i. 

Following the acknowledge cycle the CPU 
automatically pushes the Program Status and 
Program Counter onto the system stack and 
loads another Program Status and Program 
Counter from the Program Status Area. The 
Segment Trap line is reset during the segment 
trap acknowledge cycle. Suppress is not 
generated during the stack push. If the store 
creates a write warning condition, a Segment 
Trap Request is generated and is serviced at 
the end of the context swap. The SWW flag is 
also set. Servicing this second Segment Trap 
Request also creates a write warning condition, 
but because the SWW flag is set, no Segment 
Trap Request is generated. If a violation rather 
than a write warning occurs during the context 
swap, the FATL flag is set rather than the 
SWW flag. Subsequent violations cause Sup- 
press to be asserted but not Segment Trap 
Request. Without the SWW and FATL flags, 
trap processing routines that generate memory 
violations would repeatedly be interrupted and 
called to process the trap they created. 

The CPU routine to process a trap request 
should first check the FATL flag to determine 
if a fatal system error has occurred. If not, the 
SWW flag should be checked to determine if 
more memory is required for the system stack. 
Finally, the trap itself should be processed and 
the Violation Type Register reset. 


secondary storage. The Changed and Altered 
Flags in the attribute field for each segment 
can aid in implementing efficient segment 
management policies. The Status Registers can 
be used in recovering from virtual memory 
access faults. 


—_—_—_—_—_—_—_———— 


Multiple 
MMUs 
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MMU architecture directly supports two 
methods for multiple MMU configurations. The 
first approach extends single-MMU capability 
for handling 64 segments to a dual-MMU con- 
figuration that manages the 128 different 
segments the Z8001 can address. This scheme 
uses the URS flag in the Mode Register in con- 
nection with the high-order bit of the segment 
number (SNe). 

The second approach uses several MMUs to 
implement multiple translation tables. Multiple 
tables can be used to reduce the time required 
to switch tasks by assigning separate tables to 
each task. Multiple translation tables for mullti- 


task environments can use the Master Enable 
Flag to enable the appropriate MMUs through 
software. Multiple translation tables may also 
be used to extend the physical memory size 
beyond 16 megabytes by separating system 
from normal memory and/or program from 
data memory. The MST and NMS flags in the 
Mode Register can be used in conjunction with 
the N/S line to select the MMU that contains 
the appropriate table. Special external cir- 
cuitry that monitors the CPU Status lines can 
manipulate the MMU N/S line to perform this 
selection. 


DMA 
Operation © 


MMU 
Commands 


Direct memory access operations may occur 
between Z8001 instruction cycles and can be 
handled through the MMU. The MMU permits 
DMA in either the System or Normal mode of 
operation. For each memory access, the seg- 
ment attributes are checked and if a violation 
is detected, Suppress is activated. Unlike a 
CPU violation that automatically causes Sup- 
press signals to be generated on subsequent 
memory accesses until the next instruction, 
DMA violations generate a Suppress only on a 
per memory access basis. 

The DMA device should note the Suppress 
signal and record sufficient information to 
enable the system to recover from the access 
violation. No Segment Trap Request is ever 
generated during DMA, hence warning 
conditions are not signaled. Trap Requests are 
not issued because the CPU cannot 
acknowledge such a request. 


The various registers in the MMU can be 
read and written using Z8001 CPU special I/O 
commands. These commands have machine 
cycles that cause the Status lines to indicate an 
SIO operation is in progress. During these 
machine cycles the MMU enters command 
mode. In this mode, the rising edge of the 
Address Strobe indicates a command is pres- 
ent on the ADg-ADjs. If this command 
indicates that data is to be written into one of 
the MMU registers, the data is read from 
ADg-ADj5 while Data Strobe is Low. If the 
command indicates that data is to be read from 
one of the MMU registers, the data is placed 
on ADg-ADjs while Data Strobe is Low. 

There are ten commands that read or write 
various fields in the Segment Descriptor 
Register. The status of the Read/Write line 
indicates whether the command is a read or a 
write. 

The auto-incrementing feature of the Seg- 
ment Address Register (SAR) can be used to 
block load segment descriptors using the 
repeat forms of the Special I/O instructions. 
The SAR is autoincremented at the end of the 
field. In accessing the base field, first the 
high-order byte is selected and then the low- 
order byte. The command accessing the entire 
Descriptor Register references the fields in the 
order of base address, limit and attribute. 


At the start of a DMA cycle, DMASYNC 
must go Low, indicating to the MMU the 
beginning of a DMA cycle. A Low DMASYNC 
inhibits the MMU from using an indeterminate 
segment number on lines SNg-SNg. When the 
DMA logical memory address is valid, the 
DMASYNC line must be High on a rising edge 
of Clock and the MMU then performs its 
address translation and access protection func- 
tions. Upon the release of the bus at the ter- 
mination of the DMA cycle the DMASYNC line 
must again be High. After two clock cycles of 
DMASYNC High, the MMU assumes that the 
CPU has control of the bus and that subse- 
quent memory references are CPU accesses. 
The first instruction fetch occurs at least two 
cycles after the CPU regains control of the 
bus. During CPU cycles, DMASYNC should 
always be High. 


Opcode (Hex) Instruction 
08 Read/Write Base Field 
09 Read/Write Limit Field 
OA Read/Write Attribute Field 
OB Read/Write Descriptor (all fields) 
0c Read/Write Base Field; Increment SAR 
oD Read/Write Limit Field; Increment SAR 
OE Read/Write Attribute Field; Increment 
SAR 
OF Read/Write Descriptor; Increment SAR 
15 Set All CPU-Inhibit Attribute Flags 
16 Set All DMA-Inhibit Attribute Flags 


Three commands are used to read and write 
the control registers. 


Opcode (Hex) Instruction 
00 Read/Write Mode Register 
01 Read/Write Segment Address Register 
20 Read/Write Descriptor Selector Counter 
Register 


The Status Registers are read-only registers, 
although the Violation Type Register (VTR) 
can be reset. Nine instructions access these 
registers. 


Opcode (Hex) Instruction 

02 Read Violation Type Register 

03 Read Violation Segment Number Register 

04 Read Violation Offset (High-byte) Register 

05 Read Bus Status Register 

06 Read Instruction Segment Number 
Register 

07 Read Instruction Offset (High-byte) 
Register 

11 Reset Violation Type Register 

13 Reset SWW Flag in VIR 

14 Reset FATL Flag in VIR 
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MMU 
Timing 


The Z8010 translates addresses and checks 
for access violations by stepping through 
sequences of basic clock cycles corresponding 
to the cycle structure of the Z8001 CPU. The 
following timing diagrams show the relative 
timing relationships of MMU signals during the 
basic operations of memory read/write and 
MMU control commands. For exact timing 
information, refer to the composite timing 
diagram. 
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Memory Read and Write. Memory read and 
instruction fetch cycles are identical, except 
for the status information on the ST o-ST3 
inputs. During a memory read cycle (Figure 9) 
the 7-bit segment number is input on SNo-SN¢ 
one clock period earlier than the address off- 
set; a High on DMASYNC during T3 indicates 
that the segment offset data is valid. The most 
significant eight bits of the address offset are 
placed on the ADop-ADjs5 inputs early in the 


DON’T CARE 


DATA IN 


Figure 9. Memory Read Timing 
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MMU first clock period. Valid address offset data is Segment Trap Request remains Low until Seg- 


Timing indicated by the rising edge of Address ment Trap Acknowledge is received. Suppress 
(Continued) Strobe. Status and mode information become is asserted during the current machine cycle 
valid early in the memory access cycle and and terminates during T3. Suppress is 
remain stable throughout. The most significant repeatedly asserted during CPU instruction 
16-bits of the address (physical memory loca- execution cycles until the current instruction 
tion) remain valid until the end of T3. Segment has terminated. 


Trap Request and Suppress are asserted in T3. 
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Figure 10. Memory Write Timing 


591 


MMU 
Timing 
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MMU Command Cycle. During the command 
cycle of the MMU (Figure 11), commands are 
placed on the Address/Data lines during T). 
The Status lines indicate that a special I/O 
instruction is in progress, and the Chip Select 
line enables the appropriate MMU for that 
command. Data to be written to a register in 
the MMU must be valid on the Address/Data 
lines late in Tz. Data read from the MMU is 
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placed on the Address/Data lines late in the 
Twa cycle. 

Input/Output and Refresh. Input/Output and 
Refresh operations are indicated by the status 
lines STg-ST3. During these operations, the 
MMU refrains from any address translation or 
protection checking. The address lines Ag-Ajs 
remain 3-stated. 


Twa T3 
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Figure 11. I/O Command Timing 


MMU 
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Reset. The MMU can be reset by either hard- 
ware or software mechanisms. A hardware 
reset occurs on the falling edge of the Reset 
signal; a software reset is performed by a 
Z8001 special I/O command. A hardware reset 
clears the Mode Register, Violation Type 
Register and Descriptor Selection Counter. If 
the Chip Select line is Low, the Master Enable 
Flag in the Mode Register is set to 1. All other 
registers are undefined. After reset, the 
ADg-ADjs5 and Ag-Ag3 lines are 3-stated. The 
SUPand SEGT open-drain outputs are not 
driven. If the Master Enable flag is not set dur- 
ing reset, the MMU does not respond to subse- 
quent addresses on its A/D lines. To enable an 
MMU after a hardware reset, an MMU com- 
mand must be used in conjunction with the 
Chip Select line. 

A software reset occurs when the Reset 
Violation Type Register command is issued. 
This command clears the Violation Type 
Register and returns the MMU to its initial 
state (as if no violations or warnings had 
occurred). Note that the hardware and software 
resets have different effects. 


Segment Trap and Acknowledge. The Z80]0 
MMU generates a segment trap whenever it 
detects an access violation or a write into the 
lowest block of a segment with the DIRW flag 
set. In the case of an access violation, the 
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MMU also activates Suppress. This Suppress 
signal can be used to inhibit memory writes 
and to flag special data to be returned on a 
read access. The Segment Trap remains Low 
until a Trap Acknowledge signal is received. If 
a violation occurs, Suppress is asserted for that 
cycle and all subsequent CPU cycles until the 
end of the instruction; intervening DMA cycles 
are not suppressed, however, unless they 
generate a violation. Violations detected dur- 
ing DMA cycles cause Suppress to be asserted 
during that cycle only, but no Trap Request is 
generated. 

When the MMU issues a Segment Trap 
Request it awaits a Segment Trap Acknowl- 
edge. Subsequent violations occurring before 
the Trap Acknowledge is received are still 
detected and handled appropriately. During 
the Segment Trap Acknowledge cycle, the 
MMU drives one of its Address/Data lines 
High; the particular line selected is a function 
of the identification field of the mode register. 
After the Segment Trap has been acknowl- 
edged by the Z8001 CPU, the Violation Status 
Register should be read via the Special I/O 
commands in order to determine the cause of 
the trap. The Trap Type Register should also 
be reset so that subsequent traps will be 
recorded correctly. 
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Figure 12. Segment Trap and Acknowledge Timing 
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Ag-Ag3. Address Bus (outputs, active High, 
3-state). These address lines are the 16 most- 
significant bits of the physical memory 
location. 


ADs-ADj5. Address/Data Bus (inputs/outputs, 
active High, 3-state). These multiplexed 
address and data lines are used both for com- 
mands and for logical addresses intended for 
translation. 


AS. Address Strobe (input, active Low). The 
rising edge of AS indicates that ADo-ADjs, 
STo-ST3, R/W and N/S are valid. 


CLK. System Clock (input). CLK is the 5 V 
single-phase time-base input used for both the 
CPU and MMU. 


CS. Chip Select (input, active Low). This line 
selects an MMU for a control command. 


Decouple. Output from on-chip negative 
substrate-bias generator. 


DMASYNC. DMA/Segment Number Syn- 
chronization Strobe (input, active High). A 
Low on this line indicates a DMA access is 
occurring; a High indicates the segment 
number is valid. It must always be High during 
CPU cycles. 


DS. Data Strobe (input, active Low). This line 
provides timing for the data transfer between 
the MMU and the Z8001 CPU. 


N/S. Normal/System Mode (input, Low = 
System Mode). N/S indicates the Z8001 CPU 
or Z8016 DMA is in the Normal or System 
Mode. The signal can also be used to switch 
between MMUs during different phases of an 
instruction. 


RESET. Reset (input, active Low). A Low on 
this line resets the MMU. 


R/W. Read/Write (input, Low = write). R/W 
indicates the Z8001 CPU or Z8016 DMA is 
reading from or writing to memory or the 


MMU. 


SEGT. Segment Trap Request (output, active 
Low, open drain). The MMU interrupts the 
78001 CPU with a Low on this line when the 
MMU detects an access violation or write 
warning. 


SNo-SNg- Segment Number (inputs, active 
High). The SNo-SNs lines are used to address 
one of 64 segments in the MMU; SNe is used to 
selectively enable the MMU. 


STp-ST3. Status (inputs, active High). These 
lines specify the Z8001 CPU status. 


Definition 


Internal operation 

Memory refresh 

I/O reference 

Special I/O reference (e.g., to an MMU) 
Segment trap acknowledge 
Non-maskable interrupt acknowledge 
Non-vectored interrupt acknowledge 
Vectored interrupt acknowledge 
Data memory request 

Stack memory request 

Reserved 

Reserved 

Instruction space access 

Instruction fetch, first word 

Reserved 

Reserved 
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SUP. Suppress (output, active Low, open 
drain). This signal is asserted during the cur- 
rent bus cycle when any access violation 
except write warning occurs. 


oe! 
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Figure 13. The MMU in a Z8001 System 


Absolute Voltages on all inputs and outputs 


Stresses greatér than those listed under Absolute Maxi- 


Maximum with respect toGND.......... -0.3Vto +7.0V mum Ratings may cause permanent damage to the device. 
Ratinas ; ; This is a stress rating only; operation of the device at any 
g' Operating Ambient condition above those indicated in the operational sections 
Temperatunees «c..enecols acs ene 0°C to! 70°S of these specifications is not implied. Exposure to absolute 
p p' Pp 
i ti diti for extended iod: 

Storage Temperature........ -65°C to +150°C ie. aaa 
Standard The characteristics below apply for the +5V 
Test following standard test conditions, unless on 
Conditions otherwise noted. All voltages are referenced to 

GND. Positive current flows into the refer- FOINDER TEST 

enced pin. Standard conditions are as follows: 

@+4.75V < Voc S +5.25 V 50 pF bry 

gm GND =OV | 

g0°C =T, = +70°C => = = 
DC Symbol Parameter Min Max Unit Condition 
aa Vou Clock Input High Voltage Vec-0.4 Vec+0.3 Vv Driven by External Clock Generator 
istics 

VeL Clock Input Low Voltage -0.3 0.45 Vv Driven by External Clock Generator 

Vin Input High Voltage 2.0 Vec + 0.3 Vv 

Vit Input Low Voltage -0.3 0.8 Vv 

Vou Output High Voltage 2.4 Vv IoxH = -250 pA 

VoL Output Low Voltage 0.4 Vv Io, = +2.0mA 

ip Input Leakage +10 pA 0.4 < Vin = +2.4V 

Io. Output Leakage +10 pA 0.4 <= Vin = +2.4V 

Ioc Voc Supply Current 300 mA 
Ordering Temperature Number 
Information Part Number Range of Pins Package Description 

Z8010 MMU 0°C to +70°C 48 Ceramic Memory Management Unit 
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Number Symbol Parameters Min [3] Max [3] Notes 
1 TcC Clock Cycle Time 250 
2 TwCh Clock Width (High) 105 
3 TwCl Clock Width (Low) 105 
4 He Clock Fall Time 25 
5 TrC Clock Rise Time 25 
6 TdDSA(RDv) DS | (Acknowledge) to Read Data Valid Delay 100 {1] 
7 TdDSA(RDf) DS 1 (Acknowledge) to Read Data Float Delay 20 75 {1] 
8 TdDSR(BDv) DS | (Read) to AD Output Driven Delay 100 {1] 
9 DS | (Read) to Read Data Float Delay 20 25 {1] 
10 CLK | to Write Data Valid Delay 160 
11 CLK ! to Write Data Not Valid Hold Time 30 
12 Address Strobe Width 60 
13 Effset Valid to AS t Setup Time 45 
14 ThAS(OFR o Offset Not Valid Hold Time 60 
15 TdAS(C) 110 
16 TdDS(AS) 50 
17 TdAS(DS) 50 
18 TsSN(C) ! Setup Time 120 
19 ThC(SNn) CLK f to alid Hold Time 0 
20 TdDMAS(C) DMASYNC Delay 120 
21 TdSTNR(AS) Status (STp-ST3, Ali S 1 Delay 60 
22 TdC(DMA) Clk | to DMASYNC 20 
23 TdST(C) Status (STp-ST3) Valid to 140 
24 TdDS(STn) DS 1 to Status Not Valid Dela e) 
25 TdOFF(Av) Offset Valid to Address Output 75 [1,4,5] 
26 TdST(Ad) Status Valid to Address Output Driv [1,4,6] 
27 TdDS(Af) DS 1 to Address Output Float Delay {1] 
28 TdAS(Ad) AS | to Address Output Driven Delay {1, 4] 
29 TdC(Av) CLK | to Address Output Valid Delay [1, 4] 
30 TdAS(SEGT) AS 1 to SEGT | Delay (1, 2] 
31 TdC(SEGT) CLK | to SEGT 1 Delay [ly 2] 
32 TdAS(SUP) AS | to SUP | Delay [1, 2] 
33 TdaDS(SUP) DS | to SUP | Delay 30 iss [,.2] 
34 TsCS(AS) Chip Select Input Valid to AS 1 Setup Time 10 
35 ThAS(CSn) AS | to Chip Select Input Not Valid Hold Time 80 
36 TdAS(C) AS 1 to CLK t Delay 0 
37 TsCS(RST) Chip Select Input Valid to RESET 1! Setup Time 150 
38 ThRST(CSn) RESET | to Chip Select Input Not Valid Hold Time 0 
39 TwRST RESET Width (Low) 2TcC 
40 TdC(RDv) CLK | to Read Data Valid Delay 460 (1) 
4] TdDS(C) DS 1 to CLK 1 Delay 30 
42 TdC(DS) CLK | to DS t Delay 0) 110 
[1] 50 pF Load. Product Specification is specified at 100 ns with 100 pF load. 
[2] 2.2K Pull-up. With a load of 50 pF, this delay is reduced to 80 ns. 


[3] All values in nanoseconds. 

[4] These values apply to the Z8010-3 version only. A Z8010-2 
version available soon will improve these values by 40 ns. 

[5] Parameter 9 (Clock | to Address Valid) in the Z8001/2 CPU 


[6] Parameter 47 (Clock | to Status Valid Delay) in the 28001/2 
CPU Product Specification is specified at 110 ns with a 100 pF 
load. With a 50 pF load, this delay is reduced to 100 ns. 


® 
iin TSA 


AD1-ADis 


DMASYNC 


Pe 
ew oe aSS 


MEMORY ACCESS 
As-A23 


MEMORY ACCESS 
SEGT ® i) 
TRAP ACKNOWLEDGE 


z= =p : 


G5) 
p NNR COR Ty ane ae 
Gi) 
(©) 


597 


Package 
Information 


PIN 1 
IDENTIFICATION 


2.425 
MAX ie 
0.530 0.185 0.095 0.530 +.007 


ae ad MAX MAX 


_a|L_ ow 


pee 2050 -100 
+.025 BOTH ENDS +.010 TYP +.003 TYP 


48-Pin Ceramic Package 


598 


A Small Z8000 System 
Application Note 


Seek 


¥ iw Se ed 


, » 
“ier 7 sy 
’ ; i . 
| ‘ 
ee | ; : 
: i 
. i 
bp 3) 
* 
‘ 
J 2 
4 
- f 
i 
s 
‘ ~ 
s 
; 
i 
' 
, 
i 
' 
| 


A Small 
28000 System 


We 


Zilog 


Application 


Peter Alfke 


Introduction 


This application note describes the complete 
hardware design implementation of a small 
computer using the Zilog Z8002 16-bit micro- 
processor, ROMs/EPROMs and dynamic RAMs 
plus parallel and serial I/O devices. The inter- 
face requirements of the Z8002 to memory and 
to Z-80 peripherals are described and design 
alternatives are given whenever possible. 

This design is similar in structure and is soft- 
ware compatible with the Zilog Z8000 Develop- 
ment Module (part number 05-6101-01), a 
more elaborate design that offers additional 
features, such as strapping options for I/O 
space, choice of 4K or 16K RAMs, 2.5 and 
4 MHz operation from the same 20 MHz 
oscillator. 

This application note describes a simple and 
small practical Z8000 system using a minimal 
number of TTL support devices. Whenever 
possible, gate functions have been combined 
intc MSI circuits to achieve lowest component 
count and thus the lowest manufacturing cost, 


not necessarily the lowest component cost. The 
result is a tight design that uses MSI TTL cir- 
cuits in a very efficient—but sometimes non- 
obvious—way that minimizes the package 
count. Because some of the design tricks may 
not be self-explanatory, an effort has been 
made to explain them. 

A total of 22 TTL packages are used to con- 
trol the 23 to 37 MOS-LSI logic and memory 
devices. Seven TTL packages generate the 
CPU clock and buffer addresses, data and 
control lines and decode Status. Ten TTL 
packages, latch the addresses, multiplex them 
into dynamic RAMs, generate RAS/CAS 
memory control signals and generate a WAIT 
signal that slows down the processor when it 
addresses slow EPROMs. Four TTL packages 
decode I/O addresses and provide Z-80 com- 
patible control signals to the peripheral 
devices. Finally, one TTL package interfaces 
eight switches to the CPU without using up any 
of the more versatile PIO pins. 


General 
Structure 


Figure 1 shows the block diagram of this 
design. The Z8002 16-bit microprocessor is the 
heart of the system. This high-performance 
CPU offers a regular, easy to use architecture, 
an instruction set more powerful than that of 
many minicomputers, a sophisticated interrupt 
structure, and high throughput at a modest 
4 MHz clock rate that allows a memory cycle 
time of 750 ns. 

For a detailed description of the Z8002 that 
includes an instruction list with execution 
times for each instruction and each addressing 
mode, see the Z8001/Z8002 CPU Product 
Specification (03-8002-01). For a very detailed 
description of the Z8000 instruction set, refer 
to the Z8000 PLZ/ASM Assembly Language 


Manual (03-3055-01). 

Fixed program and data information is 
stored in an array of 2K x 8 ROMs or EPROMs; 
16 16K x 1 dynamic RAMs provide 32K bytes 
of read/write storage. Input/output is handled 
by five I/O devices. Two Z-80A PIOs provide 
4-byte-wide bidirectional ports (32 lines) with 
handshake control. A Z-80A SIO provides two 
fully independent full-duplex asynchronous or 
synchronous serial data communications chan- 
nels. Four counter/timers in the Z-80A CTC 
relieve the processor from simple counting and 
timing tasks and generate the programmable 
baud-rates for the serial I/O channels. Eight 
switches can be interrogated and interpreted 
by the program. 
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General 
Structure 
(Continued) 


The block diagram also indicates the various 
support functions. A crystal-controlled clock 
circuit generates a Z8002 and Z-80 compatible 
clock signal plus two complementary TTL 
clocks. Address buffers drive the memory and 
I/O devices; address latches demultiplex the 
time-shared Address/Data bus. 

The ROM array uses a 1-of-8 address 
Decoder and the RAMs are driven by an 


address multiplexer and a RAS/CAS circuit. 
The timing for all these functions originates in 
the bus control and timing circuit. The I/O 
devices are selected by an I/O decoder and 
receive Z-80 equivalent control signals 
generated by the Z8002 to Z-80 Control 
Translator. The following sections contain 
detailed descriptions of these circuits. 


a 


Clock 
Generation 


The Z8002 requires a continuously running 
clock with a frequency between 500 kHz and 
4 MHz. Most Z8002 applications are perfor- 
mance oriented and the clock rate is therefore 
usually set close to the maximum limit of 
4 MHz. At this frequency, the specified 
requirements for clock width (minimum of 
105 ns High or Low) and clock transition times 
(maximum of 20 ns rise or fall) require careful 
attention. At 4 MHz, a 50% clock duty cycle is 
indirectly implied by this specification and the 
safest way to insure it is to start with a crystal 
oscillator frequency that is twice the clock 


rate, and divide it with a toggling flip-flop. If 
this is impractical, a dc servo circuit can sense 
the average dc clock voltage level and adjust 
it to Vec/2 by changing the oscillator bias. 
The Z8002 clock input is not TTL compati- 
ble. It requires a High level within 400 mV of 
Vcc. A resistive pull-up can achieve this level, 
but cannot guarantee the required rise-time 
(20 ns from 0.8 to 4.0 V) when driving the 
= 30 pF clock input capacitance. The strin- 
gent rise time requirements dictate the use of 
an active pull-up as shown in Figure 2. 


MOS CLOCK 


2N5772 


TTL CLOCK 


TTL CLOCK 


1/6S04 


Figure 2. Clock Generation 
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CPU Output 
Buffering 


604 


The Z8002 outputs can sink 2 mA while 
maintaining TTL noise margins and can thus 
drive five LS-TTL inputs. All output delays 
are specified for a capacitive load of up to 
100 pF. They increase by approximately 
0.1 ns/pF of additional capacitive load. 


Very small systems can be built without TTL 
buffering of the CPU outputs, but most systems 
require TTL buffering of the Address/Data _ 
lines and major control outputs, like AS, DS, 
MREO and R/W. 


Bidirectional buffering of the A/D lines. The 
Address/Data lines require Bus Transceivers, 
such as the LS243 Quad Non-Inverting Bus 
Transceiver with separate Enable inputs for the 
two directions (one active High; the other 
active Low), or the LS245 Octal Non-Inverting 
Bus Transceiver with a Direction Control input 
and an active-Low Enable input. 

Figure 3 shows the logic that controls four 
LS243 Quad Transceivers; Figure 4 shows the 
even simpler logic that controls two LS245 
Octal Tranceivers. 


The bus transceivers are controlled by three 
CPU control outputs as shown in the following 
truth table. 


BUSAK R/W DS 
H H L_ Enable Receiver 
(input Data into CPU) 
H H H } Enable Transmitter 
H IS H ? (output Address or Data 
H ie LJ from CPU) 
L xX X Disable Transceiver 


ADo-ADj5 (TO/FROM CPU) 


AD-ADj5 (TO/FROM SYSTEM) 


Figure 3. Bidirectional Address/Data Buffering Using Quad Transceivers 


ADg-AD;5 (TO/FROM CPU) 


ADp-AD;5 (TO/FROM SYSTEM) 


Figure 4. Bidirectional Address/Data Buffering Using Octal Transceivers 


Unidirectional Buffering of CPU Control 
Outputs. The following CPU control outputs 
may require unidirectional buffering: AS, DS, 
MREO, R/W, N/S, B/W. 

The buffered signals must be 3-stated when 
BUSACK is Low. One LS365A or LS367A Hex 
3-State Buffer can perform this function as 
shown in Figure 5. The LS244 Octal 3-State 
Buffer buffers eight signals, but uses a 20-pin 
package. 

In a simple system, such as the one 
described here, BUSREOQ is not used, so 
BUSACK is therefore always High. In a more 
complex system with direct memory access, a 
Low on BUSACK indicates that the CPU has 
relinquished the bus. If the buffered bus is 


shared, BUSACK must be used to control the 
transceivers, as shown in Figures 4 and 5. 


FROM CPU 


AS _MREQ_N/S BIW 
Both sides of buffer Be EN 


NOTE: 


must have pull-up resistors. TO SYSTEM 


Figure 5. Control Signal Buffering 


Address 
Latching 
(Demulti- 
plexing the 
A/D lines) 


The Z8002 uses a 16-bit time-shared 
Address/Data bus that must be demultiplexed, 
that is, latched for use with standard (not 
edge-activated) memories. AS is the obvious 
control signal for address latching and two 
LS373 Octal Transparent Latches are the best 
choice for this function (Figure 6). Note that 


addresses are not guaranteed valid when AS 
goes Low. It is therefore not possible to use the 
falling edge of AS to clock the addresses into 
edge-triggered registers. The rising edge of 
AS may be used as a clock, but this delays 
address availability by almost 100 ns. Trans- 
parent latches are the better choice. 


ADo-AD;5 (FROM CPU) 


LAg-LAts (TO SYSTEM) 


Figure 6. Address Latches 


ROM 
Addressing 


RAM Address 
Multiplexing 

and RAS CAS 
Generation 


All microprocessors use nonvolatile memory 
for part of their program memory. Since the 
program status information after Reset is read 
from locations 0002 and 0004, it is natural to 
use the lower half of the addressing space for 
ROM or EPROM. 

This application uses 2716-type 2K x 8 
EPROMs addressed by the latched addresses 
LA,-LA),. Pairs of 2716s store the low and 
high byte of each word. Ag is ignored since 
the Z8002 always reads a full word from 
memory. LA)5 must be used as a Chip Select 
input to separate the ROM and RAM areas. 
When more than 2K words of ROM or EPROM 
are used, an LS138 one-of-eight decoder 
selects between the ROM and EPROM pairs. 


Dynamic 16K x 1 RAMs such as the Z6116 
provide the most efficient read/write random- 
access store. Sixteen of these devices populate 
the upper half of the addressable memory 
space (LA)s5 = High). Dynamic 16K RAMs use 
address multiplexing to reduce the package 
pin count, thus requiring only seven address 
inputs plus strobe inputs RAS and CAS. 


LA 8 1 


8 ‘2-IGrs 19) 4 


When driven with a 4 MHz clock, the Z8002 
requires a read access time (address valid from 
the CPU to data required into the CPU) of 
400 ns. After subtracting a 20 ns propagation 
delay through the LS373 address latches and 
an 18 ns propagation delay through the LS243 
transceivers, the ROM or EPROM must have 
an access time (address in to data out) of bet- 
ter than 362 ns. Most ROMs and EPROMs have 
a longer access time and therefore require an 
additional wait state that relaxes the access 
time requirement by an additional 250 ns. 
Figures 8 and 9 show a 2-input NAND gate 
that generates a Wait signal whenever LAjs is 
Low and ©2 is High, thereby adding a wait 
state to every ROM/EPROM access. 


Address Multiplexing. Two LS157 Quad Two- 
Input Multiplexers route the 14 address outputs 
LA)-LAj4 into the seven RAM address inputs. 
MREO synchronized with the rising clock 

edge is a convenient signal to control this 
multiplexer (Figure 7). LAg controls CAS as 
described later. 


FROM ADDRESS LATCHES 


125 13 6 14 7 


TO RAM ADDRESS INPUTS 


Figure 7. Address Multiplexer 
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RAM Address RAS and CAS Generation. The most demand- 


Multiplexing 
(Continued) 
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ing signals in a dynamic memory design are 
the address strobes RAS and CAS, which must 
be timed carefully with respect to the address 
information and the multiplexer control. 

Conceptually, MREO might be used as RAS 
and DS as CAS. This would, however, require 
a memory read access time from the falling 
edge of CAS of approximately 120 ns 
(parameter 33 in the Z8001/Z8002 Product 
Specification Composite AC Timing Diagram, 
minus the 30 to 40 ns used by the CAS drivers 
and bus transceivers). Only the fastest 16K 
dynamic RAMs (6116-2, for example) meet this 
requirement. Consequently, it is more prac- 
tical to use a small amount of clocked TTL 
logic to generate earlier RAS and CAS signals 
and thus relieve the access time requirements 
so that even slow 16K RAMs (6116-3, -4 and 
-5) can be used. Figure 8 shows the circuit that 
generates RAS and CAS. 

RAS is a 2-clock period (500 ns at 4 MHz) 
wide active-Low signal starting on the falling 
clock edge when AS is Low. The address infor- 
mation is valid and stable during the specified 
hold time (<50 ns) immediately after the fall- 
ing edge of RAS. RAS is generated by an 
LS109 edge-triggered dual JK flip-flop, 
clocked by CP (that is, of a polarity opposite to 
the Z8002 clock). At the end of a machine 
cycle both Ql and @2 are High. The falling 


CLOCK 


1/2 LS74 


edge of Clock during AS clocks Q1 Low. The 
next falling clock edge leaves Q1 unaffected, 
but clocks Q2 Low. The next falling edge 
clocks Q1 High and leaves Q2 unaffected. The 
next falling clock edge clocks Q2 High and 
leaves Q1 High unless AS is Low, in which 
case the cycle is repeated. Q1 is Low from the 
center of the first to the center of the third 

T state. Q2 is Low from the center of the 
second to the center of the fourth T state. 

The left half of the LS139 Dual One-of-Four 
Decoder generates CAS by ANDing three 
signals: LA}5; MREQ, which has been syn- 
chronized with Clock; and an auxilliary signal 
active during Read or DS. Uadigte 

During a read operation, CAS becomes 
active at the beginning of T3; that is, on the 
rising edge of Clock after MREQ has gone 
Low. During a write operation, CAS is delayed 
until the beginning of DS, when output data is 
guaranteed valid. The flip-flop is optional and 
stretches the width of DS, thus stretching CAS 
(during write operations) from 160 to 200 ns, 
as required by the slower memories. 

The right half of the LS139 Decoder controls 
the routing of CAS to the two memory byte 
banks. The Z8002 addresses memory as bytes, 
but usually accesses words, ignoring Ag. It 
uses Ag only when writing a byte, in which 


case it suppresses CAS to the byte bank that is 
not being written. 


Dz 
i) 


Ap Ay 
412. Ls139 

be ee SC 
3s O O 


CAS EVEN (HIGH BYTE) 


‘AS ODD (LOW BYTE) 


Figure 8. RAS, CAS, and WAIT STATE Generators 


RAM Address 
Multiplexing 
(Continued) 


CLOCK 


STATUSES 
(BIW, NIS, 
STo-STs) 


MREQ 


Q, = RAS 


MUX-S 


INSERTS WAIT STATE 


Figure 9. RAS and CAS Generation 
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RAM Address Dynamic Memory Refresh. No external hard- 

Multiplexing ware is required for memory refresh. The 

(Continued) Z8002 provides automatic memory refresh if 
properly initiated through a LDCTL instruction 
into the Refresh Control Register (Figure 10). 
Loading a 9E00 generates a refresh operation 


UPPER BYTE 


UPPER NIBBLE LOWER NIBB 


LE 


every 60 clock cycles (15 ys with a 4 MHz 
clock). This satisfies the worst-case refresh 
requirements of typical 16K dynamic RAMs. 
Figure 11 shows the relationship between the 
upper byte of the refresh control register and 
the refresh period expressed in clock cycles. 


LOWER BYTE 


ADg AD7 ADg ADs ADg AD3 AD2 AD, ADg 


Figure 10. Refresh Control Register 


LOWER NIBBLE OF UPPER BYTE 


UPPER NIBBLE OF UPPER BYTE 
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| 196 
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| 232 


228 


Figure 11. Refresh Period in Clock Cycles 


Status 
Decoding 


The Z8002 provides encoded status informa- 
tion on four outputs (STo-ST3), which dis- 
tinguish between three different interrupt 
acknowledge cycles; memory refresh; I/O 
reference; internal operation; data memory, 
stack or program memory access; and the first 


FROM 
CPU 


©PRONnN AHN FWNH BO 


word of an instruction fetch. Two LS138 
One-of-Eight decoders can generate all the 
individual Status signals. For a simple system, 
only the first ten status codes have to be 
decoded. A single LS42 One-of-Ten Decoder is 
sufficient for this purpose (Figure 12). 


INTERNAL OPERATION 
MEMORY REFRESH 

0 REQUEST 

SPECIAL 1/0 
RESERVED 


NMI 
NVI 
DATA 
STACK 


INTERRUPT 
ACKNOWLEDGE 


MEMORY 
ACCESS 


ALL OUTPUTS ACTIVE LOW 


Figure 12. Status Decoder 
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Interfacing 
Peripheral 
Devices 


Z-Bus compatible peripheral devices that 
require no external logic to interface with a 
Z8002 will become available in the near 
future. In the meantime, this application 
note describes the use of Z-80 peripherals 
(Z-80A PIO, Z-80A CTC, Z-80A SIO) with the 
Z8002. These peripherals require only three 
additional TTL packages and a few lines of 
code to make the Z8002 emulate the typical 
Z-80 control signals IOROQ, M1, RD, 
and RETI. 

Four different operations are performed 
between the CPU and its peripherals: 


O CPU writing into the peripheral device 
O CPU reading from the peripheral device 


O Peripheral interrupting the CPU, which 
responds with an Interrupt Acknowledge. 


O CPU issuing a Return from Interrupt (RETI) 
signal. 


1/2 LS20 


zi 


The first two operations—writing to or read- 
ing from the peripheral—are fairly straight- 
forward. An LS138 One-of-Eight Decoder, 
enabled by the decoded Status signal IORQ, 
decodes the latched I/O address and generates 
CE signals to the individual peripheral devices 
(Figure 13). The Z8002 can use the full 16-bit 
address space for I/O, but this application uses 
only LA3-LAj9. When necessary, the higher- 
order address bits can also be decoded and 
fed into one of the Enable inputs. 

A write operation into the enabled per- 
ipheral is performed when IORQ is Low while 
RD is High. Similarily, a read operation from 
the enabled peripheral is performed when 
IORQ is Low while RD is Low. As described 
later and shown in Figure 13 IOROQ and RD 
are controlled by an LS352 Dual Four-Input 
Multiplexer enabled by a Strobe signal that is 
active from the beginning of T2 to the end of 
T3, that is, for three clock periods (Tz, Twa, 
and T3). 


CE TO PIO 


OE TO SWITCH 


Zs 
PERIPHERALS 


STROBE 


Figure 13. Interfacing with Z-80 Peripherals 
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Interfacing 
Peripheral 
Devices 
(Continued) 
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The first four I/O devices addressed when 
LAs is Low are the four Z-80 devices (PIO 0, 
PIO 1, CTC, and SIO). The fifth peripheral is 
a set of eight switches that can be read by the 
CPU, which addresses them as peripheral. The 
user can thus specify any one of 256 different 
conditions (for example, chosing between 16 
different baud rates for each of the two serial 
I/O channels). The sixth CE output addresses a 
phantom peripheral called RETI, which is 
activated at the end of an interrupt service. 

The interrupt operation requires some extra 
logic and software to make the Z-80 peri- 
pherals compatible with the Z8002. Z-80 
peripherals request a vectored interrupt by 
pulling the VI input of the CPU Low. The CPU 
(Z-80 or Z8002) samples this input at a 
specified moment prior to the end of any 
instruction execution. The Z8002 then 
acknowledges the interrupt with a specific 
Status code (VIACK). The Z-80, which has no 
dedicated Interrupt Acknowledge output, 
acknowledges interrupts by issuing an unusual 
combination of control signals: IORQ active 
during an M1 cycle (M1 normally indicates the 
opcode fetch cycle of an instruction exe- 
cution). Z-80 peripherals resolve potential con- 
flicts between overlapping interrupt requests 
from different interrupting devices by means of 
a daisy-chain arrangement between the IEO 
outputs and the IJEI inputs of the peripheral 
devices. The highest-order peripheral has its 
IEI permanently tied High. For any peripheral 
that has no interrupt pending or under service, 
IEO=IEI. Any peripheral that has an interrupt 
pending or under service forces its IEO Low. 

To insure stable conditions in the daisy 
chain, all interrupt status signals are pre- 
vented from changing while M1 is Low. When 
IORQ is Low, the highest priority interrupt 
requestor (the one with IEI High) places its 


TORG (2-80) \ / 


HIGH 


Do-D7 VECTOR ---— 


Figure 14. Interrupt Acknowledge Cycle 


interrupt vector on the data bus and sets 

its internal interrupt-under-service latch 
(Figure 14). 

__ The circuit shown in Figure 13 generates the 
M1, IORQ, and RD signals required by the 
Z-80 peripherals during an interrupt _ 
acknowledge cycle. The timing for M1 is 
generated by STROBE, which goes High at the 
beginning of AS and stays High until the rising 
edge of DS. An LS352 Dual 4-Input Mullti- 
plexer causes IORQ to go Low when DS is 
Low, and causes RD to remain High during the 
entire interrupt acknowledge cycle. 


Return From Interrupt. At the end of an inter- 
rupt service routine the interrupt-under- 
service latch in the Z-80 peripheral that has 
been serviced must be reset. The Z-80 CPU 
accomplishes this by executing a special 
2-byte instruction with the opcode sequence 
ED-4D (RETI) appearing on the data bus. All 
peripherals monitor this sequence and 
manipulate the daisy-chain in the following 
way: 

The normal daisy-chain operation can be 
used to detect a pending interrupt; however, it 
cannot distinguish between an interrupt under 
service and a pending unacknowledged inter- 
rupt of a higher priority. Whenever “ED” is 
decoded, the daisy chain is modified by forc- 
ing High the IEO of any interrupt that has not 
yet been acknowledged. Thus the daisy chain 
identifies the device presently under service as 
the only one with an IEI High and an IEO Low. 
If the new opcode byte is “4D,” the interrupt- 
under-service latch is reset (Figure 15). 

The Z8002 does not have the equivalent RETI 
instruction and must therefore simulate it with 
a combination of hardware and software. A 
software sequence at the end of every interrupt 
service routine writes two consecutive bytes 


Figure 15. Return from Interrupt Cycle 


Interfacing 
Peripheral 
Devices 
(Continued) 


(ED followed by 4D) into the phantom peri- 
pheral called RETI. The recommended soft- 
ware sequence is as follows: 


DI Disable Interrupts 
LBD RL1, #%ED Load First Byte 
OUTB RETI, RL1 Output First Byte 
LDB RL1, #%4D Load Second Byte 
OUTB RETI, RL 1 Output Second Byte 
EI Enable Interrupts 

RET Return From Interrupt 


During the two OUTB operations, each four 
clock cycles long, RETI is Low, VIACK is High 
and the following Z-80 control signals are 
generated: M] = STROBE, IORQ_= High and 
RD = DS. As described before, STROBE is 
active during Tz, Twa, and 73, (for 750 ns at a 
4 MHz clock rate). 


Driving Z-80 Peripherals. The Z-80A PIOs, 
Z-80A CTC and Z-80A SIO are directly con- 
nected to the appropriate lines, as follows. The 
bidirectional ADo-AD7 buffers are connected 
to the Do-D7 data inputs/outputs on the 
peripherals. 

The least significant address bits LA) and 
LA? are used as Port Select (A/B) and Control 
Data select (C/D) on the PIO and SIO, and as 
Channel Select (CSg, CS) on the CTC. 

The Interrupt outputs of all peripherals are 
interconnected (pulled up with a 4.7kQ resistor 
to Vcc and connected to the VI input of the 
28002). The IEI-IEO interrupt daisy chain of 
the Z-80 peripheral devices must be connected 
appropriately to establish the desired hier- 
archy of interrupt priorities. 


a 


Conclusion 


This Application Note demonstrates that a 
small, but powerful computer can be built 
around the Z8002 16-bit microprocessor using 
a very few standard TTL support packages. It 


also shows how the readily-available Z-80 
peripheral circuits interface easily to the 
78002, taking advantage of the similarity in the 
Z-80 and Z8000 interrupt structures. 


oo ————————— 


TTL Support 


Devices 


Part Number 


Function Use 


S04 
LS04 
LS74 


LS10 
LS245 
LS365A 
LS373 
LS373 
LS157 
LS138 
LS109 
LS139 
LS74 


LS0O 
LS42 
LS138 
LS20 
LS352 
LS0OO 
LS244 


Hex Inverter 
Hex Inverter 
Dual Flip-Flop 


Triple 3-Input NAND 
Octal Buffer 

Hex Buffer 

Octal Latches 

Octal Latches 

Quad 2-Input MUX 
1-of-8 Decoder 

Dual Flip-Flop 

Dual 1-of-4 Decoder 
Dual Flip-Flop 


Quad 2-Input NAND 
1-of-10 Decoder 
1-of-8 Decoder 

Dual 4-Input NAND 
Dual 4-Input MUX 
Quad 2-Input NAND 
Octal Buffer 


Figure 
Clock Oscillator and Driver 2 
Miscellaneous 4,5, 6,8 
Clock Divider and 2and7 
MREO Synchronizer 
Address/Data Buffer Control 3 and 4 
Address/Data Buffer 4 
Control buffer 5 
Address Latching 6 
Address Latching 6 
Address Multiplexing fi 
ROM Address Decoding _— 
RAS Generation 8 
CAS generation 8 
DS Stretcher and 8 and 13 
STROBE Generator 
CAS and WAIT gating 8 
Status decoding 12 
I/O decoding 13 
1/O control 13 
Control translator 13 
Control translator 13 


Switch buffer 
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Zilog Z8000 Family 


The Art of Staying a Generation Ahead 


If you know much about micro- 
processors, you know that Zilog 
became a technology leader by 
introducing the 8-bit Z-80 Family. 
The soundness of that family 
design has been amply proven, 
and its popularity is still growing. 

Naturally, you expect Zilog to 
come up with more than just an 
extension of an 8-bit architecture 
to 16 bits. And you are right. The 
new Z8000 Family of micropro- 
cessor components is a whole 
generation ahead. Now you can 
design advanced concepts from 
the mainframe and minhicomputer 
worlds into microcomputer systems 
that do more at less cost than ever 
before. 

You won't find anything like this 
anywhere but Zilog. The advanced 
architecture, high throughput, 
intelligent peripherals and system 
flexibility of the Z8000 Family are 
sure to make it the most popular 
microprocessor of the 1980s. Want 
to find out why? Get acquainted 
with the family. Read on. 


System Flexibility. The 
Z-Family spans the gulf between 
simple stand-alone computers and 
complex multiple-processor 
systems. Your system can grow as 
your application matures or 
expands. 

Even the smallest Z8000 systems 
offer high throughput and easy 
programming far superior to any 
existing microprocessor alter- 
native. In mid-range applications, 
Z8000 components offer much 
more powerful solutions to the 
design problems of word process- 
ing, intelligent terminals, data 
communications, instrumentation 
and process control. And in a 
complex network of multiple pro- 
cessors, smart peripheral com- 
ponents, small local memories and 
a large common memory, the 
Z8000 Family provides perfor- 
mance and versatility exceeding 
that of much larger—and far more 
expensive—minicomputers. 

Higher Throughput, Reduced 
Cost. The powerful instruction set, 
high execution speed, regular 
architecture and numerous special 
features of the Z8000 CPU 
dramatically increase system 
throughput. Intelligent Z8000 
peripheral controllers unburden 
the CPU and boost throughput 
even more. 


Simply put, the Z8000 Family 
offers more for less money. The 
Z8000 CPU gives mid-range 
minicomputer performance at 
microprocessor cost. At component 
prices, Z8000 peripheral con- 
trollers perform complex system 
functions that previously required 
an entire PC board. Memory costs 
are reduced by Z-Bus memories 
that require no external logic, and 
by the compact code and moderate 
clock rate of the Z8000 CPU. 

The Z8000 Family is designed for 
multiple-processor operation—an 
economical way of greatly increas- 
ing system performance. Many 
special features for multiple Z8000 
CPUs facilitate the design of 
multiple-processor systems that 
share access to a common 
memory. The Memory Manage- 
ment Unit can dynamically 
relocate code and protect memory 
areas. The Z-UPC Universal 
Peripheral Controller, a complete 
slave microcomputer, can 
manipulate data off-line. Asyn- 
chronous parts of multiple- 
processor systems can be joined by 
the Z-FIO FIFO Interface Unit. 
Z-Bus compatible memories make 
small local memory for dedicated 
CPUs an affordable item. 
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An Unmatched CPU. The Z8000 
CPU is far more than a wider data 
path, more registers, more data 
types, more addressing modes, 
more instructions and more 
addressing space. It brings the 
big-machine concepts to the level 
of microprocessors. The instruction 
set of the Z8000 CPU is more 
powerful than that of many 
minicomputers and incorporates 
features previously found only in 
large mainframes. Its general- 
register architecture avoids bot- 
tlenecks associated with dedicated 
or implied registers. Special 
features support parallel pro- 
cessors, operating systems and 
compilers. For example, its ability 
to operate in both the System and 
Normal modes separates user pro- 
grams from the operating system 
for better software security and 
modularity. 

The Z8000 CPU is also a very 
fast machine. Its throughput is 
greater than that of any other 
16-bit microprocessor and many 
minicomputers. And the Z8000 
CPU achieves this at a moderate 
4 MHz clock rate that allows you 
the choice of slow-access, low-cost 
memories. 

How to Manage Your Memory 
Better. Modern trends are toward 
systems that have large and grow- 
ing memories, multiple users, com- 
plex programs and requirements 
for effective system security. These 
design problems pose questions 
not sufficiently answered by other 
microprocessor families. 

Another example of the Z-Family 
commitment to advanced architec- 
tural concepts, the MMU provides 
flexibility in code segment reloca- 
tion and sophistication in memory 
protection found nowhere else in 
the microprocessor world. This 
unique device encourages modular 
software development—a necessary 
trend as programs reach new 
levels of complexity. 
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You are free from specifying 
where information is actually 
located in the physical memory 
because the MMU makes software 
addresses totally independent from 
the actual physical memory 
address. Some existing micro- 
processor CPUs do have internal 
CPU relocation registers, but they 
are dedicated and support few 
segments, and these CPUs restrict 
memory protection. Not true for 
the MMU. Various MMU con- 
figurations can randomly relocate 
all 128 segments output by the 
Z8000 CPU in all its six addressing 
spaces and with various translation 
tables for each space. 

But the MMU is far more than a 
relocation device. It offers you a 
host of memory protection features 
that allow the system to protect its 
software from unwanted uses and 
users. Segments can be specified 
as read-only to protect them from 
being overwritten, as system-only 
to protect the operating system 
from inadvertent user access, as 
execute-only, and so on. A write 
warning zone is especially useful 
in stack operations so the 
operating system can deal with 
growing stacks. 

Peripheral Problem Solvers. 
Z8000 peripheral components are 
not dumb IJ/O circuits. They per- 
form intelligent, complicated tasks 
on their own. They unburden the 
CPU, reduce hus traffic and 
increase system throughput. Com- 
plex system tasks that previously 
required burdensome conglomora- 
tions of MSI, can now be handled 
off-line by Z-Bus peripherals with 
little CPU overhead. 

Multifunction Z-Bus peripherals 
are extensively programmable, so 
each can be precisely tailored to 
its application. All share common 
interrupt and bus-request struc- 
tures, as well as an I/O command 
structure that addresses up to 64 
internal registers. Z-Bus peri- 
pherals can be operated in 
priority-interrupt or polled 
environments. They offer multiple 
channels to minimize chip count. 


Counting, timing and parallel 
I/O problems seem less tiresome 
with the Z8036 Counter and 
Parallel I/O device. It has three 
16-bit counter/timers, three I/O 
ports and can even double as a 
programmable interrupt-priority 
controller. Data communications 
are neatly handled by the Z8030 
Serial Communication Controller, 
a dual-channel multi-protocol com- 
ponent that supports all popular 
communications formats. Direct 
memory access is amply supported 
by the Z8016 DMA Controller, a 
fast dual-channel device that 
enhances the addressing power of 
the Z8000 CPU in stand-alone or 
parallel-processor environments. 
You can interface a variety of CRT 
displays with the Z8052 CRT Con- 
troller, which offers a vertical or 
horizontal split screen, oversize 
alphanumerics, smooth scrolling, 
and numerous other features. 
General-purpose control and data- 
manipulation problems are 
smoothly solved by the Z8034 
Universal Peripheral Controller, a 
complete off-line microcomputer- 
on-a-chip with three I/O ports. 
This processor executes the same 
friendly, capable instruction set as 
our Z8 Microcomputer. Bits and 
pieces of asynchronous parallel- 
processing systems are intercon- 
nected by the Z8038 FIO Interface 
Unit, a surprisingly flexible device 
that can interface any major 
microprocessor and most peri- 
pherals to the Z-Bus. Its buffer 
depth can be expanded without 
limit using the Z8060 FIFO. Small 
local memory is affordable because 
the Z6132 4K x 8 Quasi-Static 
Z-Bus RAM requires no external 
interface circuitry, and it refreshes 
itself. 


Z8001/Z8002 CPU 
Central Processing 
Unit 
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Product 
Brief 


Features 


@ Regular, easy-to-use architecture. 


@ Instruction set more powerful than many 
minicomputers. 


@ Directly addresses 8M bytes. 
@ Eight user-selectable addressing modes. 


@ Seven data types that range from bits to 
32-bit long words and word strings. 


@ System and normal operating modes; 
separate code, data and stack spaces. 


@ Sophisticated interrupt structure. 


@ Resource-sharing capabilities for 
multiprocessing systems. 


@ Multi-programming and compiler support. 


@ Memory management and protection pro- 
vided by Z8010 Memory Management Unit. 


@ 32-bit operations, including signed multiply 
and divide. 


@ Z-Bus compatible. 
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Description 


The Z8000 is an advanced high-end 16-bit 
microprocessor that spans a wide variety of 
applications ranging from simple stand-alone 
computers to complex parallel-processing 
systems. Essentially a monolithic minicomputer 
central processing unit, the Z8000 CPU is 
characterized by an instruction set more 
powerful than many minicomputers; resources 
abundant in registers, data types, addressing 
modes and addressing range; and a regular 
architecture that enhances throughput by 
avoiding critical bottlenecks such as implied or 
dedicated registers. 

CPU resources include sixteen 16-bit 
general-purpose registers, seven data types 
that range from bits to 32-bit long words and 
word strings, and eight user-selectable 
addressing modes. The 110 distinct instruction 
types can be combined with the various data 
types and addressing modes to form a powerful 
set of 414 instructions. Moreover, the instruc- 
tion set exhibits a high degree of regularity: 
most instructions can use any of the five main 
addressing modes and can operate on byte, 
word and long-word data types. 

The CPU can operate in either system or 
normal modes. The distinction between these 
two modes permits privileged operations, 
thereby improving operating system organiza- 
tion and implementation. Multiprogramming is 


supported by the “atomic” Test and Set 
instruction; multiprocessing by a combination 
of instruction and hardware features; and com- 
pilers by multiple stacks, special instructions 
and addressing modes. 
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The Z8000 CPU is offered in two versions: 
the Z8001 48-pin segmented CPU and the 
Z8002 40-pin non-segmented CPU. The main 
difference between the two is in addressing 
range. The Z8001 can directly address 8M 
bytes of memory; the Z8002 directly addresses 
64K bytes. The two operating modes—system 
and normal—and the distinction between code, 
data and stack spaces within each mode allows 
memory extension up to 48M bytes for the 
Z8001 and 384K bytes for the Z8002. 

To meet the requirements of complex, 
memory-intensive applications, a companion 
memory-management device is offered for the 
Z8001. The Z8010 Memory Management Unit 
manages the large address space by providing 
features such as segment relocation and 
memory protection. The Z8001 can be used 
with or without the Z8010. If used by itself, the 
Z8001 still provides an 8M byte direct address- 
ing range, extendable to 48M bytes. 


Register Organization. The Z8000 CPU isa 
register-oriented machine that has sixteen 
16-bit general-purpose registers. The Z8002 


CPU has one stack pointer register, and the 
Z8001 has two. 


Stacks. The Z8001 and Z8002 can use stacks 
located anywhere in memory. Two implied 
stack pointers are available: the system stack 
pointer and the normal stack pointer. 


Refresh. The Z8000 CPU contains a counter 
that can be used to refresh dynamic memory 
automatically. 


Program Status Registers. This group of 
status registers contains the program counter, 
flags, and control bits. These are automatically 
saved when an interrupt or trap occurs, anda 
new status group is loaded. 


Interrupt and Trap Structure. The CPU sup- 
ports three types of interrupts: vectored and 
nonvectored maskable, and nonmaskable. 
There are four traps: system call, 
unimplemented instruction, privileged instruc- 
tion, and segmentation trap. 


Data Types. Z8000 instructions can operate on 
bits, BCD digits (4 bits), bytes (8 bits), words 
(16 bits), long words (32 bits), byte strings and 
word strings up to 64K bytes long. 


Segmentation and Memory Manage- 
ment. The Z8001 can directly access 8M bytes 
of address space, using a segmented address- 


ing scheme, implemented via the Z8010 MMU 
Memory Management Unit. The 8M bytes of 
Z8001 address space is divided into 128 
relocatable segments of up to 64K bytes each. 
The addresses entered into instructions and 
output by the CPU in executing them are 
logical addresses. The MMU translates these 
logical addresses into addresses in physical 
memory. This process—relocation—is 
transparent to the user software. 


Addressing Modes. Eight addressing modes 
are provided in the instruction set: Register 
(R), Immediate (IM), Indirect Register (IR), 
Direct Address (DA), Indexed (X), Relative 
Address (RA), Base Address (BA), and Base 
Indexed (BX). 


Input/Output. A set of I/O instructions per- 
forms 8-bit or 16-bit transfers between CPU 
and I/O devices. 


Multimicroprocessor Support. A pair of CPU 
pins is used in conjunction with certain 
instructions to coordinate multiple 
microprocessors. 

Instruction Set. The Z8000 has in its reper- 
toire the nine categories of instructions follow- 
ing: 

@ Load and exchange 

@ Arithmetic 

@ Logic 

@ Program control 

@ Bit manipulation 

@ Rotate and shift 

@ Block transfer and string manipulation 

@ Input/output 

@ CPU control 

Status Lines. Seven pins of the Z8000 are 
dedicated to the issuance of status information. 
Three are the function select lines Read/Write, 
Normal/System, and Byte/Word. The other four 
lines (STo-ST3) issue codes denoting type of 
operation (program or I/O reference, data or 
stack memory request, or internal operation), 
acknowledging external requests (segment trap 


or interrupt), and initiating memory refresh 
cycles. 


28010 MMU 
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Features 


Description 


gw Dynamic segment relocation makes software 
addresses independent of physical memory 
addresses. 


@ Sophisticated access validation protects 
memory areas from unauthorized or unin- 
tentional access. 


@ MMU architecture supports multiprogram- 
ming systems. 


Declining memory costs coupled with the 
increasing power of microprocessors has 
accelerated the use of high-level languages, 
sophisticated operating systems, complex pro- 
grams and large data bases in micromputer 
systems. The Z8001 microprocessor CPU sup- 
ports these trends with an eight megabyte 
direct address space as well as a rich and 
powerful instruction set. The Z8010 Memory 
Management Unit (MMU) provides flexible and 
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Brief 


Preliminary 


m Sixty-four variable-sized segments from 256 
to 64K bytes can be managed within a total 
physical address space of 16M bytes; all 64 
segments are randomly accessible. 


@ Multiple MMUs can support several transla- 
tion tables for each of the six Z8001 address 
spaces. 


efficient support for this large address space 
by offering dynamic segment relocation as well 
as numerous memory-protection features. 

The primary memory of a computer is one 
of its major resources. As such, the manage- 
ment of this resource becomes a major con- 
cern as demands on it increase. These 
demands arise from multiple users (or multiple 
tasks within a dedicated application), the need 
to increase system integrity by limiting access 
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to various portions of the memory, and from 
the need to structure large, complex programs 
and systems. 

Multiple tasks (or users) of a system that 
can reside anywhere in memory are called 
relocatable. Generally, systems in which all 
tasks are relocatable offer far greater flexibility 
in responding to changing system environ- 
ments. Another aspect of multiple-task envi- 
ronments is sharing: separate tasks can 
execute the same program on different data, or 
several tasks may execute different programs 
using the same data. 

Unfortunately, a problem that arises in 
multiple-task systems is that of system integrity. 
Tasks must be protected from unwanted inter- 
actions with other tasks; user tasks must be 
prohibited from performing operating system 
functions; and user tasks must also be pro- 
tected from themselves so they cannot overflow 
the areas allotted to them. 

In addition to these considerations, support 
for the design and implementation of large, 
complex programs and systems is itself an 
important consideration. Modern trends are 
toward the partitioning of a complex task into 
small, simple, self-contained subtasks that have 
well-defined interfaces. Because these subtasks 
interact with each other, communication 
between them must be carefully controlled. 
Memory-management systems can offer effec- 
tive solutions for implementing large systems 
modularly designed. 

The Z8010 Memory Management Unit sup- 
ports multiple-process and large modular soft- 
ware systems with dynamic segment relocation. 
Futhermore, it enhances system integrity with 


a powerful set of memory protection features. 


Relocation. Dynamic segment relocation 
makes user software addresses independent of 
the physical memory addresses, thereby free- 
ing the user from specifying where information 
is actually located in the physical memory and 
providing a flexible, efficient method for sup- 
porting multi-programming systems. 

The Z-MMU uses a translation table to 
transform the 23-bit logical addresses from the 
Z8001 CPU into 24-bit addresses for the 
physical memory. Memory segments are 
variable in size from 256 bytes to 64K, in 
increments of 256 bytes. Pairs of Z-MMUs sup- 
port the 128 segment numbers available for the 
various Z8001 CPU address spaces. Within an 
address space, any number of Z-MMUs can be 
used to accommodate multiple translation 
tables for system and normal operating modes, 
or to support more sophisticated memory- 
management systems. 


System Integrity. Z-MMU memory-protection 
features safeguard memory areas from 
unauthorized or unintended access by 
associating special access restrictions with 
each segment. A segment is assigned a “per- 
sonality” consisting of several attributes when 
it is initially entered into the Z-MMU. When a 
memory reference is made, these attributes are 
checked against the status information sup- 
plied by the Z8001 CPU. If a mismatch occurs, 
a trap is generated and the CPU is inter- 
rupted. The CPU can then check the status 
registers of the MMU to determine the cause 
and take appropriate action to correct the pro- 
blem. 
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Figure 3. The MMU in a Z8000 System 
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Features 


@ Multiplexed address/data bus, shared by 
I/O and memory. 


@ Peripherals may be asynchronous. 
@ Up to 24-bit memory address, 16-bit I/O. 
@ 8 or 16 data bits. 


@ Daisy-chained bus request. 
@ Daisy-chained resource request. 
@ Vectored or nonvectored interrupts. 


™ Separate memory and I/O address space. 


Description 


The Z-bus is a shared bus that links the com- 
ponents of the Z8000 family. A bus user can be 
any device that can generate bus transactions. 
Five different types of transactions can be 
passed on the Z-bus to serve the basic needs of 
I/O and memory structures in a distributed- 
processing environment. The five types are: 


@ Memory access 
g I/O transfer 

@ Interrupt 

@ Bus request 

@ Resource request 


Direct addressing of the internal registers of 
peripherals is facilitated by the use of 
multiplexed address and data lines. (See 
Figure 1.) The Z-bus is asynchronous, so 
peripherals’ clocks need not be synchronized 
with the CPU clock, which is therefore not 
transmitted on the bus directly. The signals 
(strobes, acknowledges, etc.) generated in the 
course of any transaction provide all necessary 
timing information. 


Memory Access. Status signals issued by the 
CPU distinguish memory transactions from 
others and select the address space to be 
accessed. Slow memory devices may assert the 
WAIT signal to prolong the transaction. 
Extended addresses may be used with the 
segmented Z8001 CPU and the Z8010 MMU. 
Other status signals define direction (R/W), 
Normal/System (N/S), Byte/Word (B/W), and 
the various address spaces. 
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Figure 2. Interrupt Connections 


I/O Transfer. The status line I/O reference 
distinguishes I/O transactions from others. The 
16-bit multiplexed bus is used for address and 
data (without extension), and AS, DS, R/W, 
B/W, and WAIT are used in a similar way. 
Direct addressing of the internal registers of 
peripherals is facilitated by the use of 
multiplexed address and data lines. (See 
Figure 1.) The Z-bus is asynchronous, so 
peripherals’ clocks need not be synchronized 
with the CPU clock, which is therefore not 
transmitted on the bus directly. The signals 
(strobes, acknowledges, etc.) generated in the 
course of any transaction provide all necessary 
timing information. 
Interrupt. The Z-bus interrupt scheme is an 
interrupt-under-service priority daisy chain 
that requires no separate priority controller. 
Interrupt requests are all tied directly to the 
INT pin of the CPU. (See Figure 2.) Physical 
position along the IEI/IEO daisy chain deter- 
mines the priority assigned to any given 
peripheral. Upon receipt of an INT signal, the 
CPU issues an INTACK. (See Figure 3.) This 
temporarily inhibits further interrupt requests, 
while all devices that have initiated interrupt 
requests prior to that INTACK drop their IEO 
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Figure 3. Interrupt Acknowledge Timing 


outputs. (Multiple INTs might occur 
simultaneously.) The highest-priority IEO has 
the effect of removing IEI inputs from all 
devices beyond it on the same daisy chain, 
thereby preventing them from requesting inter- 
rupts further until their IEI inputs are restored. 
Three Wait cycles after the leading edge of 
INTACK (or more, if WAIT has been asserted 
by the highest-priority device requesting ser- 
vice), to allow the chain to settle, a DS from 
the CPU stimulates the one highest-priority re- 
questing peripheral to place its vector on the 
bus. Two (or more) additional Wait cycles 
later, the service routine is invoked, and 
INTACK is returned high. At this time, all re- 
guesters of higher priority than the one being 
serviced (those whose IEI lines are still high) 
are enabled, and may generate new interrupt 
requests. Once a peripheral has been serviced 
it unmasks the daisy chain so lower-priority in- 
terrupts can be generated. 


Bus Request. The bus request is used to 
transfer control of the Z-bus for memory or I/O 
transactions. The BUSROQ input line to the 
Z-bus CPU, the wired-OR of BRO outputs from 
all requesters, initiates a bus request. The 
BUSAK output line from the CPU is daisy- 
chained through BAI inputs and BAO outputs 
of all requesters in order of priority, to grant 
use of the bus to the first requester whose 
BAO is held high at that time. 


Resource Request. The resource request 
chain is used to share a resource among 
several Z-bus CPUs, none of which is default 
master of that resource. The resource-request 
protocol is similar to that of the bus request, 
except for an added status line that inhibits all 
requesters from issuing requests any time the 
resource is busy. The acknowledge daisy-chain 
resolves contention in the event of simul- 
taneous requests. 


Z8034 UPC 
Universal 
Peripheral Controller 


Product 
Brief 


Preliminary 


Features 


@ Complete slave microcomputer, for 
distributed-processing Z-bus use. 


@ Unmatched power of Z8 architecture, 
instruction set. 


@ Three programmable I/O ports, two with 
2-wire handshake, or any combination of 
data and control lines. 


@ Six levels of priority interrupts to Z-UPC. 


@ Two programmable 8-bit counter/timers with 
6-bit prescalers. 


@ 256 byte register file, accessible by both 
master CPU and Z-UPC, as allocated by 
Z-UPC program. 

@ 2K bytes of on-chip program ROM for effi- 
ciency, versatility. 


Description 


The Z-UPC Universal Peripheral Controller 
is a distributed microcomputer that performs 
the three basic interfacing functions needed to 
interface a CPU with peripherals: device con- 
trol by ROM-resident internal software, data 
manipulation, such as reformatting or 
arithmetic, and data buffering in internal 
registers. 

The Z-UPC is similar to the Z8 microcom- 
puter and uses the Z8 instruction set. Under 
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program control, its three 8-line I/O ports can 
be tailored to the needs of its user. Perma- 
nently configured as a single-chip controller 
with 2K bytes of internal ROM, the Z-UPC 
executes instructions in 2.2 ws average using a 
4-MHz clock source. Its register file contains 
256 bytes, of which 234 are general-purpose 
registers, 19 are status and control registers, 
and three are port registers. 
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Z-BUS TO 
MASTER 
CPU 


The Z-UPC Universal Peripheral Controller 
is an intelligent device that generates all the 
control signals peripheral devices need. 
Because it does off-line arithmetic, translates 
data before transmitting, and buffers data, the 
Z-UPC unburdens the master CPU, thereby 
increasing the overall speed and efficiency of 
the system in which it resides. 

Based upon the Z8 microcomputer architec- 
ture, the Z-UPC offers fast execution time, effi- 
cient use of memory, and sophisticated inter- 
rupt, I/O, and bit manipulation. Its powerful 
and extensive instruction types, combined with 
its efficient internal register addressing 
scheme, not only speeds program execution, 
but also efficiently packs program into the on- 
chip ROM. 

A unique characteristic of the Z-UPC is its 
register file, which contains I/O port and con- 
trol registers that can be accessed both by the 
Z-UPC program and by its associated master 
CPU. This results in byte efficiency, program- 
ming efficiency, and address space efficiency 
because Z-UPC instructions can operate direct- 
ly on I/O data without moving it to and from 
an accumulator. It also allows the Z-UPC user 
to allocate as data buffer between the CPU and 


iNT 

INTACK 
1El ——e] 
1EO 


ED 
INTERRUPT 
Locic 


INTERNAL INSTRUCTION BUS 


INTERNAL DATA BUS 


ALU 
AND 
| ete 


the peripheral all register space not in use as 
accumulators, address pointers, index regis- 
ters, or stack. Registers not used as buffer are 
protected against CPU access. The register file 
is divided into 16 groups of 16 working regis- 
ters each. A register pointer uses fast, short- 
format instructions to access any one of these 
groups quickly, resulting in fast and easy task 
switching. Two-way communication between 
the master CPU and the register file is 
facilitated by another pointer that positions 16 
interface registers anywhere within the register 
file. These registers are accessed directly by 
both the master CPU and the slave Z-UPC. 
Four more registers, similarly accessed, con- 
vey control and status information. 

All of the Z-bus’s daisy-chained priority 
interrupt system can be implemented in the 
Z-UPC under software control, or the Z-UPC 
can be programmed to function in a polled 
environment. In all, the Z-UPC has 24 pins 
that can be dedicated to I/O functions. 
Grouped logically into three 8-line ports, they 
can be programmed in many combinations of 
inputs, outputs, and bidirectional lines, with or 
without handshake and with push-pull or open- 
drain outputs. 
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Figure 3. Functional Block Diagram 


Z8 MCU 
Microcomputer 
Unit 


Product 


Zilog Brief 
Preliminary 
Features ® Complete microcomputer, 2K bytes of ROM, can access any of nine working-register 


32 I/O lines, and up to 62K 
addressable external space each for pro- 
gram and data memory. 


@ 144-byte register file, including 124 
general-purpose registers, 4 I/O ports 
registers, and 16 status and control 
registers. 


@ Full-duplex UART and two programmable 
8-bit counter-timers, each with a 6-bit pro- 
grammable prescaler. 


@ Register pointer so short, fast instructions 


groups in 1.5 ps. 

@ Average instruction execution time of 
2.2 ws, maximum of 4.25 ps. 

@ Vectored, priority interrupts for I/O, 
counter-timers, and UART. 


@ On-chip oscillator which accepts crystal, 
RC, or LC reference or external clock 
drive. 


@ Low-power standby option which retains 
contents of general-purpose registers. 


Description 


The Z8 microcomputer introduces a new 
level of sophistication to single-chip architec- 
ture. Compared to earlier single-chip micro- 
computers, the Z8 offers faster execution; more 
efficient use of memory; more sophisticated 
interrupt, input/output and bit-manipulation 
capabilities; and easier system expansion. 

Under program control, the Z8 can be 
tailored to the needs of its user. It can be con- 
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Figure 1. Pin Functions 


figured as a stand-alone microcomputer with 
2K of internal ROM, a traditional micropro- 
cessor that manages up to 124K of external 
memory, or a parallel-processing element in a 
system with other processors and peripheral 
controllers linked by the Z-Bus. In all con- 
figurations, a large number of pins remain 
available for I/O. 


Figure 2. Pin Assignments 
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Description 
(Continued) 


Z8 architecture is characterized by a flexible 
I/O scheme, an efficient register and address 
space structure and a number of ancillary 
features that are helpful in many applications. 

Microcomputer applications demand power- 
ful I/O capabilities. The Z8 fulfills this with 
32 pins dedicated to input and output. These 
lines are grouped into four ports of eight lines 
each and are configurable under software con- 
trol to provide timing, status signals, serial or 
parallel I/O with or without handshake, and an 
address/data bus for interfacing external 
memory. 

Because the multiplexed address/data bus is 
merged with the I/O-oriented ports, the Z8 can 
assume many different memory and I/O con- 
figurations. These configurations range from a 
self-contained microcomputer to a 


OUTPUT INPUT 


ADDRESS OR I/O 


microprocessor that can address 124K of exter- 
nal memory. 

The Z8 offers three basic address spaces to 
support this wide range of configurations: pro- 
gram memory (internal and external), data 
memory (external) and the register file (inter- 
nal). The 144-byte random-access register file 
is composed of 124 general-purpose registers, 
4 I/O port registers, and 16 control and status 
registers. 

To unburden the program from coping with 
real-time problems such as serial data com- 
munication and counting/timing, the Z8 offers 
an on-chip asynchronous receiver/transmitter 
(UART), and two counter/timers with a large 
number of user-selectable modes. Hardware 
support for the UART is minimized because 
one of the on-chip timers supplies the bit rate. 
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Z8/64 


The 64-pin development version of the 


Development 40-pin mask-programmed Z8 allows the user to 


Device 


626 


prototype the system in hardware with an 
actual Z8 device, and develop the code that is 
eventually mask-programmed into the on-chip 
ROM of the Z8/40. 

The Z8/64 is identical to the Z8/40 with the 


following exceptions: 
@ The internal ROM has been removed. 


™ The ROM address lines and data lines are 
buffered and brought out to external pins. 


= Control lines for the new memory have been 
added. 


28036 CIO 
Counter/Timer and 
Parallel I/O Unit 


Wa Product 


. a 
Zilog Brief 
Preliminary 
Features @ Two independent 8-bit double-buffered @ Three independent 16-bit counters. 
bidirectional I/O ports plus a special- @ All registers read/write and directly 
purpose 4-bit I/O port. Sr taceanl a: 
@ Four handshake modes including IEEE-488. @ Flexible pattern recognition logic, program- 
@ Wait/Request line for high speed data mable as 16-input interrupt controller. 
transfer. 

Description The Z8036 CIO Counter/timer and Parallel byte port or a bit port. In the bit mode, data 
I/O element is a general purpose peripheral direction is programmable bit by bit. In the 
circuit that satisfies most counter/timer and handshake mode, the ports can be input, out- 
parallel I/O needs encountered in system put, or bidirectional, and they may be linked 
designs. This versatile device contains three to form a 16-bit port. The four handshake 
I/O ports and three counter/timers. Many pro- modes include IEEE-488, interlocked (for inter- 
grammable options tailor its configuration to facing to a Z-UPC, Z-FIO or another Z-CIO), 
specific applications. The use of the device is strobed and pulsed. The pulsed mode connects 
simplified by making all internal registers one counter/timer with the handshake logic for 
(command, status, and data) readable and interfacing a mechanical device such as a 
(except for status bits) writable. Also, each printer. The 4-bit port provides handshake 
register is given its own unique address so it controls, special controls (Wait/Request) or 
can be accessed directly—no special sequen- general-purpose I/O. 
tial operations are required. The Z-CIO is The counter/timer section contains three 
directly Z-bus compatible. 16-bit counters, two of which can be software- 

Either 8-bit I/O port can be a handshake configured as a 32-bit counter/timer. Up to 
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Description 
(Continued) 
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four I/O lines for each counter are available 
for direct external control and status informa- 
tion. All counters have a programmable output 
duty cycle, continuous or single-cycle oper- 
ation, and the counting process can be pro- 
grammed to be either retriggered or nonretrig- 
gered. 

Figure 3 shows how the Z-CIO is used. The 
two general purpose 8-bit ports are similar. 
They can be programmed as handshake 
driven, double-buffered ports (input, output, 
or bidirectional) or as control ports in which 
the direction of each bit is individually pro- 
grammable. Port B can also be specified to 
provide external access for two of the counter/ 
timers. Each port includes pattern recognition 
logic allowing interrupt generation when a 
specified pattern is detected. The pattern 
recognition logic can be programmed so that 
the port functions like a priority interrupt con- 
troller. 

To control these capabilities, each port con- 
tains 13 registers. Three of these, the input, 
output, and buffer registers, are data path 
registers. Two others, the mode specification 
and handshake specification registers, define 
the mode of the port and specify what hand- 
shake to use, if any. The reference pattern for 
the pattern recognition logic is defined in 
three registers, the pattern polarity, pattern 
transition, and pattern mask registers. The 
detailed characteristics of each bit path (for 
example, the direction of data flow, or whether 
a path is inverting or noninverting) are pro- 
grammed using the data path polarity, data 
direction, and special I/O control registers. 
The primary control and status bits are 
grouped in a single register so that after the 
ports are configured initially, only this register 
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need be accessed often. One register contains 
the interrupt vector associated with each port. 
To facilitate initialization, the port logic is 
designed so that if a capability of the port is 
not required the registers associated with that 
capability are ignored and need not be pro- 
grammed. 

The function of port C depends upon the 
roles of ports A and B. Port C provides hand- 
shake lines for the other two when required. 
Any bits of port C not so used can be used as 
I/O lines or as external access to the third 
counter/timer. 

Besides the data input and output registers, 
three registers are needed. These specify the 
details of each bit path: data path polarity, 
data direction, and special I/O control. 

The three counter/timers are all identical. 
Each is composed of a 16-bit down-counter, a 
16-bit time constant register (which holds the 
value loaded into the down-counter), a 16-bit 
current count register (used to read the con- 
tents of the down-counter), and two 8-bit 
registers for control and status (the mode 
select and control registers). All three share a 
common vector register. 

Each counter/timer can be programmed as 
either counter or timer. Up to four port I/O 
lines can be designated as external access 
lines for it. The lines are: Counter Input, Gate 
Input, Trigger Input, and Counter/Timer Out- 
put. Three different counter/timer output duty 
cycles are available: pulse, one-shot, or 
square wave. The operation of the counter/ 
timer can be specified to be either single cycle 
or continuous. The counting sequence may be 
retriggered or nonretriggered, under program 
control. 


Figure 3. Functional Block Diagram 


Z8030 SCC Serial 
Communications 
Controller 


Or Product 
Zilog Brief 


Preliminary 


Features @ Two independent, 0 to 1 Megabit-per- @ Bisynchronous mode with internal or exter- 


second, full-duplex channels, each with its 
own quartz oscillator, baud-rate generator, 
and digital phase-locked loop for clock 
recovery. 


@ Multi-protocol operation under program 
control. 


nal character synchronization on one or two 
sync characters and CRC generation and 
checking with CRC-16 or CRC-CCITT 
preset to either 1s or Os. 


SDLC/HDLC mode with comprehensive 


frame-level control, automatic zero insertion 


Mi fe yichrenbus made WiEnonee ne and I and deletion, I-field residue handling, abort 
igi sta Hils- par cleaner  recHiain: generation and detection, CRC generation 
mable clock factor; break detection and and checking, and loop mode operation. 
generation; parity, overrun, and framing @ Programmable for NRZ, NRZI, or FM 
error detection. coding. 

® Local loopback and auto-echo modes. 

Description The Z-SCC Serial Communication Controller external random logic on the circuit card. 


The Z-SCC handles asynchronous formats, 
synchronous byte-oriented protocols such as 
IBM Bisync, and synchronous bit-oriented pro- 
tocols such as HDLC and IBM SDLC. This ver- 
satile device also supports virtually any other 
serial data transfer application (cassette or 
diskette interface, for example). 

The device can generate and check CRC 


is a dual-channel, multi-protocol data com- 
munication peripheral for Z-bus use. It is 
software-configured to satisfy a wide variety of 
serial communication applications. Its basic 
function is serial-to-parallel and parallel-to- 
serial conversion. However, the Z-SCC also 
contains a repertoire of new, sophisticated 
internal functions that minimize the need for 
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Description 
(Continued) 


Typical 
Applications 


630 


codes in any synchronous mode and can be 
programmed to check data integrity in various 
modes. It also has facilities for modem controls 
in both channels. In applications where these 
controls are not needed, the modem controls 
can be used for general-purpose I/O. 

As is standard among Zilog peripheral com- 
ponents, the Z-bus daisy-chain interrupt 
heirarchy is supported. 

The Z-SCC contains the necessary multi- 
plexed address/data bus interface with strobe 
and chip select lines to function as a Z-bus 
peripheral. It includes internal control and 
interrupt logic, two full-duplex channels and 
two baud-rate generators. Associated with 
each channel are several read and write 
registers for mode control as well as the logic 
necessary to interface to modems or other 
external devices. 


The read and write register group for each 
channel includes eight control registers, two 
sync-character registers, and four status 
registers. Each baud rate generator has two 
read/write registers for holding the time con- 
stant that determines baud rate. Associated 
with the interrupt logic is a write register for 
interrupt vector and three read registers: vec- 
tor with status, vector without status, and inter- 
rupt pending status. 

The logic for both channels provides format- 
ting, synchronization and validation for data 
transferred to and from the channel interface. 
The modem control inputs are monitored by 
the control logic under program control. All of 
the modem control signals are general purpose 
in nature and optionally can be used for func- 
tions other than modem control. 
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Figure 3. Functional Block Diagram 


Figure 4 shows how a Z-SCC can be con- 
nected with channel A programmed for the 
Synchronous Data Link Control (SDLC) Loop 
mode, functioning as a secondary station. If 
NRZI or FM coding is used, no clock lines are 
required because the clock can be recovered 
from the received data, using the Z-SCC’s on- 
chip digital phase locked loop (DPLL). 
Another Z-SCC (not shown), programmed for 
the SDLC mode, would be the controlling sta- 
tion, polling the loop for traffic. The figure 
shows a typical, asynchronous serial port 
being serviced by channel B of the Z-SCC. It 
could just as well support another synchronous 
data link, or even a high-speed link, transfer- 
ring data via a DMA controller. 
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Figure 4. Loop Secondary Station and Serial Port 


26132 4K x 8 


Quasi-Static RAM 


Up 


Zilog 


Product 
Brief 


Preliminary 


Features @ Byte-wide organization: 4096 words by @ Industry-standard 28-pin DIP with JEDEC- 
eight bits. recommended pinout. 
m Access and cycle times guaranteed over m +10% tolerance on single +5 V supply 
voltage and temperature range: voltage. 
Part Number Access Time Cycle Time w Automatic self-refresh scheme with slow-and 
26132-3 200 ns 325 ns fast-cycle modes. 
Z6132-4 250 375 
6132-5 300 is 425 a @ All inputs and outputs are TTL compatible 
@ On-chi : 
@ Low power consumption: 200 mW active, Dasshipy siiopiate!Diag generator 
125 mW stand-by. @ Interfaces readily to Z8 and Z8000. 
Description The Zilog Z6132 is a +5 V intelligent MOS The Z6132 uses high-performance depletion- 


dynamic RAM organized as 4096 words by 
eight bits. Although it uses single-transistor 
dynamic storage cells, the Z6132 effectively 
functions as a static RAM because it performs 
and controls its own refresh. This eliminates 
the need for external refresh circuitry and 
combines the convenience of a static RAM with 
the high density and low power consumption 
normally associated with a dynamic RAM. 

The Z6132 is particularly suited for 
microprocessor and minicomputer applications 
where its byte-wide organization, transparent 
self-refresh operation and single supply 
voltage reduce the parts count and simplify the 
design. 
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Figure 1. Pin Functions 


load double-poly n-channel silicon-gate MOS 
technology with a mixture of static and 
dynamic circuitry that provides a small 
memory cell, fast access and low power con- 
sumption. The Z6132 has separate pins for 
addresses and bidirectional data I/O to pro- 
vide maximum flexibility in its application. 

The circuit is packaged in an industry- 
standard 28-pin DIP and pin compatible with 
the proposed JEDEC standard. 

The Z6132 conforms with the Z-Bus specifica- 
tion used by the new generation of Zilog 
microprocessors, the Z8 and Z8000. 
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Description 
(Continued) 


The Z6132 4K x 8 quasi-static RAM is orga- 
nized as two separate blocks, each having two 
sets of 64 rows on either side of the 128 sense 
amplifiers. Both blocks have separate and 
independent row address buffers and 
decoders, but they share the column decoder 
and the internal 8-bit wide data path. The two 
sets of row address decoders are addressed 
either by the address inputs A,-Az or by the 
internal 7-bit refresh counter. The least signifi- 
cant address input (Ag) selects one of the two 
blocks for external access. While the selected 
block performs a read or write operation, the 
other memory block uses the refresh counter 
address to refresh one row. Details of the self- 
refresh mechanism are explained later. 

A memory cycle starts when the rising edge 
of Address Strobe (AS) clocks in Chip Select 
(CS), Ag, and Write Enable (WE). If the chip 
is not selected (CS = High), all other inputs 
are ignored for the rest of the cycle (that is, 
until the next rising edge of AS). Both memory 
blocks are self refreshed by the 7-bit refresh 
counter. If the chip is selected (CS = Low), 
the 12 address bits and the Write Enable bit 
are clocked into their registers. Ay determines 
which block is addressed by A,-Aj,; the other 
block is refreshed by the 7-bit refresh counter. 

The Chip Select and Address inputs must be 
valid only during a short hold time after the 
rising edge of AS. This allows address/data 


multiplexing, because data I/O is controlled by 
a separate control input Data Strobe (DS). 


Read Cycle. A read cycle is initiated by the 


rising edge of Address Strobe (AS) while Chip 
Select (CS) is Low and Write Enable (WE) 
High. A Low level on the Data Strobe (DS) 
input activates the Data outputs after a 
specified delay from the rising edge of AS as 
well as the falling edge of DS, whichever 
comes later. During a read operation, DS is 


nothing but a static Output Enable signal. 


Write Cycle. A write cycle is initiated by the 

rising edge of Address Strobe (AS) while Chip 
Select (CS) is Low and Write Enable (WE) are 
Low. 

The WE input is checked again at the begin- 
ning (falling edge) of Data Strobe (DS). If WE 
is still Low, this falling edge of DS edge- 
triggers the data on the Do-D7 inputs into the 
addressed memory location. Data must be 
valid only during a short hold time after the 
falling edge of DS. 


Write Inhibit Cycle. After a write cycle has 
been initiated, the actual write operation can 
still be aborted by pulling WE High again 
before the falling edge of DS. This write 
inhibit cycle is a special feature that permits 
starting a write cycle early at AS time, but still 
allows the option of inhibiting the write opera- 
tion later at DS time. 
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Z8038 FIO 
FIFO Input/Output 
Interface Unit 


Product 
Brief 


Preliminary 


Zilog 


Features 


gw Asynchronous bidirectional FIFO buffer, 
used with most major microprocessors as 


CPU/CPU or CPU/peripheral interface. 


@ Interlocked or IEEE-488 handshake port 
mode; Empty, Full, and Wait/Request lines 
for high-speed data transfer. 


@ 128 x 8 organization, expandable to 16 bits 
wide; cascadable to any depth. 


m Pattern recognition logic stops DMA transfer 
and/or interrupts CPU. 


mw Preset byte count in FIO buffer can inter- 


rupt CPU. 


w All registers read/write and directly 


addressable. 


a 


Description 


The Z-FIO is a general-purpose micro- 
processor interface that provides elastic buffer- 
ing between asynchronous CPUs in a parallel- 
processor network or between CPU and 
peripheral circuits. The Z-FIO can interface a 
Z-bus microprocessor or any other major pro- 
cessor to another microprocessor or to a 
peripheral circuit or port. 

In Z8000 systems, the FIO furthers dis- 
tributed-processor operation because it can 
interconnect components or subsystems 
operating at different speeds. Also, it can 
increase system throughput by transferring 
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Figure 1. Pin Functions 


words as well as bytes. This bidirectional 
device accepts data and holds it until it can be 
used by another device in the system. In most 
I/O transactions, introducing a 128-deep buffer 
cuts interrupt servicing overhead by two 
orders of magnitude. 

The Z-FIO greatly facilitates system 
throughput by moving variable-size blocks 
under either direct memory access or interrupt 
control—an especially important consideration 
when fast peripheral circuits need interfacing. 
Complete status information is also provided 
for operation in polled environments. 
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Pin Z-Bus Z-Bus General Interlocked IEEE 488 
Assignments Low Byte High Byte Purpose HS Port* HS Port* 
[A] REG/WT REO/WT REO/WT RFD/DAV RFD/DAV 
[B] DMASTB DMASTB ACK ACKIN DAV/DAC 
c DS DS RD FULL DAC/RFD 
[D] R/W R/W WR EMPTY EMPTY 
(El cs S cS CLEAR CLEAR 
[F] aS AS cD DATA DIR DATA DIR 
[e] INTACK Ag INTACK INo INo 
[x] IEO Ay IEO OUT, OUT, 
1] IEO Ap IEI IN2 IN2 
Oi] INT A; INT OUT; OUT; 
“B side only. See table below. 
Description The internal functions of the Z-FIO are and also are fed into a subtractor to determine 
(Continued) — shown in the block diagram (Figure 3). It is the current number of bytes in the memory. 
made up of two sides that are identical except This number can be read by either CPU from a 
for programming. The side programmed by status register dedicated to each side. Another 
pins Mo and Mj is called the A side; the side programmable register is compared against the 
programmed by bits SLo and SL) is called the status register to generate an interrupt and/or 
B side. Common to both, and situated between start and stop DMA transfers. A pair of port 
the two sides, is the 128 x 8 RAM used for registers allows for communication between 
data storage, two 7-bit counters, and various CPUs, bypassing the main buffer memory. 
registers. The RAM is capable of simultaneous, Operating Modes. The Z-FIO has twelve 
independent read and write operations. This different programmable modes. (Table below.) 
Meets for example, that the A side CPU oan The states of two package pins determine the 
write a byte of data into the FIO without dis- mode of operation of the A side, and the B 
turbing a simultaneous read operation by the B side is programmed by two bits (SLo and SL) 
side CPU. The outputs of the read and write in one of the A side control registers. 
counters are used to address the buffer RAM, 
To 
TO OR GENERAL 
an Gencant MICECEROCESSOR 
MICROPROCESSOR PORT WITH 
HANDSHAKE 
Figure 3. Functional Block Diagram 
Operating Mode M, My SL, Slo A B 
Modes 
0 0 0 0 (0) Z-Bus Low Byte Z-Bus Low Byte 
1 (0) 0 0 1 Z-Bus Low Byte General »P 
2 0 0 l 0 2-Bus Low Byte IEEE 488 HS 
3 0 0 1 1 Z-Bus Low Byte Interlocked HS 
4 0 1 0 0 Z-Bus High Byte Z-Bus High Byte 
5 (0) 1 0 1 Z-Bus High Byte General pP 
6 0 1 l 0 2-Bus High Byte IEEE 488 HS 
v7 0 1 1 1 Z-Bus High Byte Interlocked HS 
8 1 (0) (¢) 0 General pP Z-Bus Low Byte 
9 1 (0) Oo 1 General p»P General pP 
10 1 0 1 ) General pP IEEE 488 HS 
11 1 0 1 1 General pP Interlocked HS 
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Z8060 FIFO 
FIFO Buffer Unit 
and Z-FIO Expander 


Wa Product 


Zilog Brief 
Preliminary 
Features g Asynchronous, bidirectional first-in, first-out @ 3-state data outputs. 
buffer. @ Empty and Full status pins are wire-ORed 
m Extends depth of Z-FIO without limit. among multiple stages. 


@ 128 x 8 organization. 


Description The Z-FIFO first-in, first-out buffer unit is a 
128 x 8-bit memory with bidirectional data 
transfer capability and handshake logic. Its 
structure is similar to that of other FIFOs that 
are commonly available, such as the AM2812 DATA 
and the 3351. The handshake logic used is 
compatible with that of the Z8, the Z-CIO, and 
Z-FIO. Z-FIFO buffers can be cascaded, end to 
CONTROL 


end, without limit, their RFD/DAV and ACKIN 

signals daisy-chained, to make a FIFO array 

any desired number of words deep. Two such 

channels in parallel, suitably controlled, make sae 


up a 16-bit-wide buffer array. 


Figure 1. Pin Functions 
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Figure 2. Using FIFOs to Extend FIOs 
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More to Come 


The components described in 
the foregoing Product Briefs exist 
now or are well along in their 
development. These components 
represent the first step of an on- 
going commitment to support the 
Z8000 Family. The next step is a 
series of specialized processors 
and peripherals that includes the 
Z8016 DMA Controller, Z8052 CRT 
Controller and Z8065 Burst Error 
Processor. 

28016 DMA Controller. This 
high-speed (2M byte/sec) versatile 
dual-channel DMA controller 
matches the power and addressing 
capability of the Z8000 CPUs. It 
supports a variety of system 
implementations, ranging from 
dedicated single-DMA configura- 
tions to distributed multiple-DMA 
configurations found in multi-user, 
multi-tasking environments. 

The Z8016 takes full advantage 
of the Z8000 memory management 
scheme because it interfaces 
directly to the Z8010 Memory 
Management Unit. Consequently, 
8M bytes of logical address range 
are provided for each CPU 
address space. Alternatively, the 
Z8016 can operate independently 
of the Z8010 MMU and directly 
address up to 16M bytes of 
physical address space. 
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The ability to self-load control 
parameters from memory enables 
chained DMA operations of dif- 
ferent types, and provides a high 
degree of independence from the 
CPU. Memory-to-Memory data 
transfers as well as the more con- 
ventional data transfer between 
I/O and memory can be executed. 
Data transfers can be in the form 
of single byte, double byte or 
word, and a number of search and 
match operations can be per- 
formed on the data. 

Several different interrupt 
stimuli can be enabled under pro- 
gram control. These include inter- 
rupts on Terminal Count (TC), End 
of Process (EOP), or a number or 
condition bits in the Channel 
Mode Register. The Z8016 operates 
within the Z8000 daisy-chain 
vectored-priority interrupt scheme. 


Z8052 CRT Controller. The 
Z8052 is a broad-application, 
raster scan CRT controller 
specifically designed to interface 
the Z8000 CPU to a variety of CRT 
displays. 

Its numerous advanced features 
suit a wide variety of applications 
including general-business and 
scientific data processing, word 
processing and graphics. 

Text-editing software implemen- 
tation is simplified by means of 
variable vertical and horizontal 
split-screen capability. Double 
character-cell display with vertical 
adjustment of character position 
enhances word processing as well 
as scientific and mathematical 
notation. Character justification 
along with mixing of fonts is 
achieved by external synchroniza- 
tion of vertical retrace and 
variable character clock fre- 
quency. Typewriter formatted 
single- or multiple-line spacing 
along with oversized alpha- 
numerics or memory bit-mapped 
displays can be generated with 
variable scan lines per character 
row. Simple line drawing capabil- 
ity is also made available with the 
line attributes provided. 


The Z8052 programmable 
register architecture allows easy 
operating configuration and mode 
changes under software program 
control. This contrasts favorably to 
the time consuming and costly 
ROM programming methods used 
by other CRT controllers. 

These advanced display features 
are achieved with the ability to 
change attributes dynamically on a 
real-time basis. The ability to 
change row attributes in real time 
allows smooth scrolling. Character 
attributes changing in real time 
allow multiple cursors and various 
underline combinations, all with 
individual blink rates. The 
character attributes control normal 
or double character cells for 
subscripted and superscripted 
display as well as the line 
attributes used for line drawing. 
This allows intermixing of forms 
and text displays for various 
applications. 


Dynamic change of attributes is 
achieved by using a separate 
display refresh RAM in which the 
data for changing attributes is 
stored in parallel with the 
displayed character data. Data 
transfers from host processor to 
display RAM are made without 
memory access contention pro- 
blems between Z8052 CRTC and 
processor. This is achieved by set- 
ting up the display RAM address- 
ing so the first half of the 
character clock period is used for 
CRTC functions and the second 
half is used for host processor data 
transfer. 


Z8065 Burst Error Processor. 
The Z8065 Burst Error Processor 
provides high-speed error correc- 
tion for Z8000 disk-based systems 
or other Z8000 systems in which 
high-speed data transfer takes 
place. With data transfer rates and 
storage size increasing in both 
floppy and solid disks, error rates 
without correction become increas- 
ingly intolerable. The Z8065 com- 
plements the Z8000 and its 
peripherals in systems using high- 
speed or high-density peripheral 
interfaces such as solid disk or 
floppy disk drives. 

The Z8065 provides a selection 
of the four generator polynomials 
popularized by IBM, Digital Equip- 
ment Corporation and Calcomp. 
The divide mode performs division 
of the data stream by the selected 
polynomial to generate the check 
bits during data transfer to disk. 
For read operations, the divide 
mode can detect errors that may 
have occurred in a read or write. 
To locate the error for correction, 
a second compute mode identifies 
the error pattern and assists in 
finding the error location in the 
data stream. 
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